create-mn-fullstack

Scaffold a full-stack Midnight dApp project with smart contracts, CLI, and React frontend.

Usage

npx create-mn-fullstack my-project

What's included

| Directory | Description | |---|---| | midnight-local-network/ | Local Midnight node via Docker + wallet funding scripts | | midnight-starter-template/ | Full-stack Counter dApp — smart contracts (Compact) + CLI + React frontend + tests |

Project structure (midnight-starter-template)

midnight-starter-template/
├── counter-contract/         # Compact smart contracts + ZK keys
├── counter-cli/              # CLI tools for deployment & interaction
└── frontend-vite-react/      # React + Vite frontend with wallet integration

Frontend stack

• React 19 + Vite + TypeScript
• TailwindCSS + Radix UI (shadcn-style)
• TanStack Router
• Midnight wallet widget integration
• ZK proof (WASM) support

Prerequisites

• Node.js 23+ & npm 11+
• Docker (for local network)
• Midnight Compact compiler (for contract compilation)
• Git LFS (for large files)
• Lace wallet extension (browser wallet)

Quick start

npx create-mn-fullstack my-project

# Start local network
cd my-project/midnight-local-network
docker compose up -d
npm install && npm run fund

# Build contracts + frontend
cd ../midnight-starter-template
npm install
npm run build

# Setup env and start frontend
cp frontend-vite-react/.env_template frontend-vite-react/.env
npm run dev:frontend

Development

To update bundled templates from the repo:

cd create-mn-fullstack
bash sync-templates.sh
npm publish