scaffold-foc

Ship on Filecoin
in one command.

scaffold-foc generates a working Next.js app that uploads, retrieves, and verifies real storage — and checks your whole setup before you waste an afternoon on wallets and approvals.

GitHub →

Node 20+ · Runs against the Filecoin calibration testnet

See it in action
Live preview

Watch the setup run itself.

Every scaffolded project ships with foc:check — a script that verifies your entire Filecoin setup and tells you exactly what to fix.

my-project — foc:check
Workflow

From nothing to stored, in three steps.

01

Scaffold the project

One command gives you a Next.js app with the Synapse SDK, upload and retrieve routes, and the foc: scripts already wired up.

npx scaffold-foc my-project
cd my-project
npm install
02

Check and fund

Add your calibration key, then let the CLI tell you exactly what is missing and provision it for you.

npm run foc:check
npm run foc:setup
03

Store your first file

Start the dev server and upload to real Filecoin storage. The round trip is already built.

npm run dev
The foc: scripts

Filecoin's trickiest setup, as one-liners.

npm run foc:check

Inspects wallet, RPC, gas, USDFC balance, providers, and approvals — with a fix for every failing line.

npm run foc:setup

Deposits USDFC and grants operator approval in one transaction so uploads stop getting rejected.

npm run foc:test-upload

Uploads a small file and pulls it back, proving a real round trip against live storage.

npm run foc:status

Reports account funds, data sets, and proof state — the health of everything you have stored.

In the box

Everything a scaffolded project ships with.

Start building on Filecoin.