explaingit

flowstack-fun/flowstack-sdk

Analysis updated 2026-05-18

2TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

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
Click or tap to explore — scroll the page freely

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

TypeScriptReactNext.jsMongoDBVite

How does it compare?

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 get it running?

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.

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub flowstack-fun on gitmyhub

Verify against the repo before relying on details.