One-step CLI toolkit to bootstrap production-ready Next.js + Stellar applications.
npm install nextellarbash
npx nextellar my-app
`
- Built-in Stellar support
- Horizon & Soroban endpoints configured
- Wallet-adapter plugin system (Freighter, XBull, Ledger, etc.)
- React Hooks
- useStellarAccount(), useStellarPayment(), useTrustlines(), useTransactionHistory(), useSorobanContract()
- UI Components
- , , , , , ,
- Opinionated stack
- Next.js (v13+ App Router) + TypeScript
- Tailwind CSS + shadcn/ui
- ESLint, Prettier, Jest + React Testing Library
- Storybook for component previews
- GitHub Actions CI for linting, testing, and build
---
π¦ Installation
_No global install required:_
`bash
npx nextellar my-app
cd my-app
npm install
npm run dev
`
_Or install globally:_
`bash
npm install -g nextellar
nextellar my-app
`
---
βοΈ CLI Usage
`bash
Usage: nextellar [options]
Options:
-t, --typescript Generate a TypeScript project (default)
-j, --javascript Generate a JavaScript project
--horizon-url Override default Horizon endpoint
--soroban-url Override default Soroban RPC endpoint
-w, --wallets Comma-separated list of wallet adapters
-d, --defaults Skip prompts and use defaults
--skip-install Skip dependency installation after scaffolding
--package-manager Choose package manager (npm, yarn, pnpm)
--install-timeout Installation timeout in milliseconds (default: 1200000)
-v, --version Show CLI version
-h, --help Show help text
`
---
π Project Structure
`bash
my-app/
βββ public/ # Static assets (logos, icons)
βββ src/
β βββ app/ # Next.js App Router (Layouts & Pages)
β βββ components/ # Reusable UI components (WalletButton, etc)
β βββ contexts/ # React Contexts (WalletProvider)
β βββ hooks/ # Custom Stellar hooks (useStellarAccount, etc)
β βββ lib/ # Core logic and SDK initializations
βββ tailwind.config.ts # Styling configuration
βββ tsconfig.json # TypeScript configuration
βββ package.json # Project dependencies
βββ README.md # You are here!
``