flo-quickstart-nextjs

The fastest way to ship tokenized US equity exposure inside a Next.js app.

Heads up. The Flo sandbox API is in private beta for design partners. With no FLO_SANDBOX_KEY set, this demo runs in mock mode and returns canned responses so the UI flow works end-to-end. To call the live sandbox, apply for design-partner access.

A Next.js 16 App Router demo that mints tokenized AAPL through the Flo API. Form on the client, server action that calls /v1/mint with your sandbox key, response rendered back to the user. Under 100 lines of working code.

What it does

User picks a ticker and quantity, clicks Tokenize. The server action calls POST /v1/mint against sandbox.flo.finance, gets back a tokenized position (1:1 backed at SEC-registered broker-dealers under the hood), and the UI shows the resulting token contract address and tx hash.

The whole flow runs on the sandbox, so no KYC, no funding, no real money. Ten minutes from git clone to first mint.

Run it

git clone https://github.com/flo-finance/flo-quickstart-nextjs
cd flo-quickstart-nextjs
npm install
npm run dev

Open http://localhost:3000 and tokenize 10 shares of AAPL. The demo runs in mock mode out of the box.

To call the live sandbox once you have access:

cp .env.example .env.local
# paste your sandbox key from https://flo.finance/dashboard/developers/keys

Deploy

Set FLO_SANDBOX_KEY in your Vercel project. That's it.

Going live

Swap FLO_SANDBOX_KEY for FLO_LIVE_KEY and change env: "sandbox" to env: "live" in app/actions.ts. KYB review takes about two business days. The same code runs against real prime-broker fills.

Useful next steps

• Read the Flo docs
• Apply to be a design partner for $5K–$10K of integration credit
• See the other demos for Privy, RainbowKit, and FastAPI versions

License

MIT.