A starter kit for building on Filecoin Onchain Cloud — upload, manage, and pay for decentralized storage using the Synapse SDK.
- Multi-file, multi-copy uploads with three modes: standard, Filecoin Beam (CDN addon), and Filecoin Pin (IPFS addon)
- Store-pull-commit workflow — upload once, providers replicate from each other, saving bandwidth
- USDFC payments — deposit, withdraw, and auto-topup with balance sufficiency checks
- Session keys — optional delegated signing for seamless multi-operation workflows
- Dashboard — real-time balances, storage metrics, and per-dataset cost breakdowns
- Dataset & file browsing — inspect pieces, download with CID validation, delete
git clone https://github.com/FIL-Builders/fs-upload-dapp
cd fs-upload-dapp
pnpm install
pnpm devOpen http://localhost:3000. You'll need a web3 wallet with testnet tokens — the app includes a built-in faucet under the wallet menu's Add Funds option in the navbar, or use these directly:
- tFIL — Calibration Faucet
- tUSDFC — ChainSafe Faucet (limit $5/request)
For a detailed code walkthrough of every workflow, see tutorial.md.
| Resource | Description |
|---|---|
| tutorial.md | Code walkthrough of every workflow in this dApp |
| AGENTS.md | Agent-optimized codebase reference (architecture, file map, all APIs) |
| Filecoin Onchain Cloud Docs | Core concepts, developer guides, API reference |
| Synapse SDK | SDK source and examples |
| USDFC Docs | Stablecoin used for storage payments |
Next.js 16 (static export) · React 19 · TypeScript 5 · Tailwind CSS 4 · shadcn/ui · Wagmi 3 · RainbowKit · TanStack Query · Zustand
Contributions welcome — feel free to open a PR.
MIT