gitwtfhub

wtf is flowstack-sdk?

flowstack-fun/flowstack-sdk — explained in plain English

Analysis updated 2026-05-18

2TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TL;DR

A TypeScript npm package that gives React apps authentication, MongoDB-backed data storage, streaming AI agents, and payments through hooks, with no backend code required.

Mindmap

mindmap
  root((repo))
    What it does
      Auth and user sessions
      MongoDB data hooks
      Streaming AI agents
      Site publishing
    Core Hooks
      useAuth
      useCollection
      useAgent
      useWorkspace
    Use Cases
      AI chat apps
      Data-driven sites
      Wallet payments
    Tech Stack
      TypeScript
      React
      MongoDB
      Vite

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Add user login and per-user data storage to a React app without writing any backend code

REASON 2

Build a chat interface where users talk to an AI agent that reads and writes app data from MongoDB

REASON 3

Publish AI-generated sites with a two-step upload and promote workflow

REASON 4

Wire up crypto wallet payments in a web app using the Flowstack wallet module

What's in the stack?

TypeScriptReactNext.jsMongoDBVite

How it stacks up

flowstack-fun/flowstack-sdkarashthr/hugo-flowargeneau12e/kairos-tx
Stars222
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatehard
Complexity3/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a Flowstack platform account, the base URL points to a hosted service at sage-api.flowstack.fun.

The README does not specify a license for this SDK.

Wtf does this do

Flowstack SDK is a TypeScript package that provides a complete set of building blocks for AI-powered web applications. Instead of writing your own backend server, you install one npm package and get authentication, data storage, AI agent integration, file handling, and wallet-based payments through a set of React hooks. The idea is that a frontend developer can build a full-stack AI application without managing any server infrastructure. The main pieces are React hooks, each covering a distinct area. The useAuth hook handles user sign-in. The useCollection hook connects to a MongoDB-backed data layer for reading and writing application data. The useAgent hook connects to a streaming AI agent that can answer questions or write structured results back to a collection in one call. There are also hooks for datasets, visualizations, workspace management, and site publishing. One specific use case the SDK supports is what it calls built apps: AI-powered sites generated by a build pipeline. These sites use a two-step process where you upload source files to a staging slot, then explicitly promote that version to make it live. The SDK includes a detailed checklist of requirements for this pattern, including a buffer polyfill that must appear at the top of the entry file, specific Vite configuration rules, and notes about which authentication component to use. The documentation is generated from a canonical registry and includes a human-readable reference site, an OpenAPI specification, a machine-readable text file for AI coding tools, and a semantic graph. This keeps the human docs and the API contract consistent. The SDK is installed from npm or from a CDN-hosted tarball for generated sites. The README does not state a specific open-source license. The full README is longer than what was shown.

Yoink these prompts

Prompt 1
I want to build a React app where users log in and chat with an AI agent that answers questions from a MongoDB collection. Show me how to set up FlowstackProvider, useAuth, and useAgent together.
Prompt 2
Walk me through the Flowstack built-app deploy process: upload source files, check the draft, and promote it to live.
Prompt 3
I'm getting a 'Can't find variable: Buffer' error in my Flowstack app. What is the required fix and where in the project does it go?
Prompt 4
How do I use the useCollection hook to insert and query documents in Flowstack's MongoDB backend from a React component?

Frequently asked questions

wtf is flowstack-sdk?

A TypeScript npm package that gives React apps authentication, MongoDB-backed data storage, streaming AI agents, and payments through hooks, with no backend code required.

What language is flowstack-sdk written in?

Mainly TypeScript. The stack also includes TypeScript, React, Next.js.

What license does flowstack-sdk use?

The README does not specify a license for this SDK.

How hard is flowstack-sdk to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is flowstack-sdk for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.