create-story-app
v0.0.1
Published
Scaffold a Story dApp in seconds, pre-configured with wallet connectivity, on-chain IP data hooks, and a complete design system.
Downloads
14
Readme
create-story-app
Scaffold a production-ready Story dApp in seconds. Comes pre-configured with wallet connectivity, on-chain IP data hooks, and a complete design system.
Quick Start
npx create-story-app my-appYou'll be prompted to choose a framework. Or pass it directly:
npx create-story-app my-app --template next
npx create-story-app my-app --template viteThen start the dev server:
cd my-app
npm run devTemplates
| Template | Framework | Description |
| -------- | -------------------- | ------------------------------------- |
| next | Next.js (App Router) | Server components, file-based routing |
| vite | Vite + React | Fast HMR, client-side SPA |
Both templates include the same Story Protocol integrations and design system.
What's Included
- Story Protocol Core SDK — Register IP, manage licenses, royalties, and disputes
- Story Global Wallet — Cross-app account abstraction wallet (auto-appears in wallet selector)
- IPKit — React hooks for reading on-chain IP asset data
- RainbowKit + wagmi — Wallet connection UI with Story chain pre-configured
- Tailwind CSS v4 + shadcn/ui — Component library with a custom design system
- TypeScript — Strict mode, path aliases (
@/*)
Options
| Flag | Description |
| ------------------------ | -------------------------------------- |
| --template <next|vite> | Skip the framework prompt |
| --skip-install | Skip automatic dependency installation |
Environment Variables
All environment variables are optional — default API keys are included so the app works out of the box. To use your own keys, copy .env.example to .env.local:
| Variable | Description |
| -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID / VITE_WALLET_CONNECT_PROJECT_ID | WalletConnect project ID from WalletConnect Cloud |
| NEXT_PUBLIC_STORY_API_KEY / VITE_STORY_API_KEY | Story Protocol API key for IPKit. Overrides the default public StoryKit API keys. |
Note: Next.js uses the
NEXT_PUBLIC_prefix for client-side env vars. Vite uses theVITE_prefix.
Story Global Wallet
The Story Global Wallet with gas sponsorship (ZeroDev account abstraction) is only supported on mainnet.
Learn More
License
MIT
