Midnight Network Development Skills

Comprehensive GitHub Copilot customizations for building privacy-preserving DApps on Midnight Network with Next.js 16.1.1.

✨ What's Included

This repository provides a complete AI-assisted development environment:

• 📚 11 Agent Skills - Specialized knowledge for Midnight and web development
• 🤖 8 Custom Agents - Expert personas for different development scenarios
• 📝 18 Reusable Prompts - Workflow templates for common tasks
• 📋 10 Instruction Sets - Context-aware coding guidelines

🌙 About Midnight Network

Midnight is a privacy-first blockchain that combines public verifiability with confidential data handling using zero-knowledge proofs (ZKPs) and selective disclosure.

📚 Agent Skills

All skills follow the Agent Skills specification with the structure:

skill-name/
├── SKILL.md          # Required: Main skill definition
├── assets/           # Static resources (templates, configs)
└── references/       # Additional documentation

Available Skills

Skill	Description	Location
compact	Compact smart contract language for Midnight Network	skills/compact/
dapp-integration	Wallet connection, providers, and contract deployment	skills/dapp-integration/
midnight-network	Network infrastructure, proof servers, indexers	skills/midnight-network/
nextjs	Next.js 16.1+ App Router, Server Components, MCP	skills/nextjs/
playwright	End-to-end testing with Playwright	skills/playwright/
prisma	Type-safe database access with Prisma ORM	skills/prisma/
privacy-patterns	ZK proofs, commitments, nullifiers, selective disclosure	skills/privacy-patterns/
security	Security auditing for Midnight contracts and dApps	skills/security/
tailwindcss	Tailwind CSS v4 styling patterns	skills/tailwindcss/
testing	Contract testing with simulators and Vitest	skills/testing/
turborepo	Monorepo build system configuration	skills/turborepo/

🤖 Custom Agents

Specialized AI personas in agents/:

Agent	Description	Best For
fullstack-developer	Full-stack Next.js + Midnight developer	General dApp development
midnight-smartcontract-developer	Compact contract specialist	Smart contract design
security-auditor	Security auditor for ZK and privacy patterns	Vulnerability detection
security-review	Systematic security reviewer	Audit reports
api-developer	API and backend specialist	REST APIs, Server Actions
devops-engineer	DevOps and infrastructure	CI/CD, Docker, Vercel
e2e-testing-engineer	E2E testing specialist	Playwright, testing
ui-designer	UI/UX designer	Tailwind CSS, components

📝 Reusable Prompts

Workflow templates in prompts/:

Prompt	Description
add-privacy-feature	Add privacy patterns to an existing project
audit-security	Perform security audits
create-compact-contract	Generate complete Compact contracts
create-component	Create React components with wallet integration
create-docker-setup	Add Docker setup for local dev services
create-e2e-tests	Create Playwright E2E tests
create-rest-api	Create REST API routes/handlers
create-turborepo	Scaffold a Turborepo monorepo
create-ui-component	Create UI components (Tailwind, a11y)
debug-contract	Debug compilation or runtime errors
deploy-contract	Compile and deploy contracts
design-database-schema	Design a Prisma schema and migrations
implement-privacy-feature	Add privacy patterns
integrate-wallet	Set up wallet connection in Next.js
optimize-contract	Optimize for gas efficiency
setup-authentication	Add authentication patterns
setup-cicd	Add CI/CD pipelines
setup-testing	Configure testing infrastructure

📋 Instruction Sets

Context-aware guidelines in instructions/:

Instructions	Applies To	Description
compact	**/*.compact	Compact language coding standards
midnight-typescript	**/*.{ts,tsx}	TypeScript with Midnight APIs
privacy-patterns	**/contracts/**	ZK and privacy patterns
testing	**/test/**	Contract testing guidelines
nextjs	**/app/**	Next.js App Router patterns
playwright	**/e2e/**	Playwright testing patterns
prisma	**/prisma/**	Prisma ORM patterns
tailwindcss	**/*.{css,tsx}	Tailwind CSS patterns
turborepo	**/turbo.json	Monorepo configuration
memory	Global	Persistent learnings

🚀 Quick Start

Note: Midnight docs commonly list Node.js 20+ as a prerequisite, but create-mn-app currently requires Node.js 22+ for its templates (per the npm package page). If you want the least-fuss setup, use Node.js 22+.

# 1. Install Compact developer tools (v0.3.0)
curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/midnightntwrk/compact/releases/download/compact-v0.3.0/compact-installer.sh | sh

# 2. Install the latest compiler
compact update

# 3. Start the proof server (in separate terminal)
docker run -p 6300:6300 midnightnetwork/proof-server -- midnight-proof-server --network testnet

# 4. Create a project (recommended)
npx create-mn-app my-midnight-dapp
cd my-midnight-dapp

# 5. Develop your DApp
npm run dev

🛠️ Technology Stack

• Midnight Network - Privacy-first blockchain
• Next.js 16.1.1 - React framework with App Router
• TypeScript - Type-safe development
• Compact compiler 0.26.0 - Smart contract compiler (Minokawa)
• Compact language 0.18.0 - Language version (pragma language_version 0.18;)
• Compact developer tools 0.3.0 - CLI tooling (compact)
• Docker - Proof server container
• Node.js - 22+ recommended (20+ minimum)
• Lace Wallet - Browser extension for Midnight

🔗 Resources

• Documentation: https://docs.midnight.network/
• Network Support Matrix (compatibility): https://docs.midnight.network/relnotes/support-matrix
• Release notes (index): https://docs.midnight.network/relnotes/overview
• Discord: https://discord.com/invite/midnightnetwork
• GitHub: https://github.com/midnightntwrk
• Agent Skills Spec: https://agentskills.io/specification

📜 License

MIT License - Educational resources for the Midnight Network developer community.

---

Start your privacy-preserving DApp journey today! 🌙