🚀 EDDA - Midnight Starter Template

This project is built on the Midnight Network.

• A starter template for building on Midnight Network with React frontend and smart contract integration.
• Live Demo → counter.nebula.builders

📦 Prerequisites

• Node.js (v22+) & pnpm (v10+)
• Docker
• Git LFS (for large files)
• Compact (Midnight developer tools)
• Lace (Browser wallet extension)
• Faucet (Preview Network Faucet)

🛠️ Setup

1️⃣ Install Git LFS

# macOS
brew install git-lfs

# Debian/Ubuntu
sudo apt install git-lfs

# Fedora/RHEL
sudo dnf install git-lfs

# Initialize Git LFS (run once per machine)
git lfs install

2️⃣ Install Compact Tools

# Install the latest Compact tools
curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/midnightntwrk/compact/releases/latest/download/compact-installer.sh | sh

# Install the latest compiler 
compact update +0.30.0

3️⃣ Install Node.js, pnpm and Docker

• Node.js (v22+)
• pnpm (v10+)
• Docker

4️⃣ Verify Installation

# Check versions
node -v
pnpm -v
docker -v
git lfs version
compact check  # Should show latest version

📁 Project Structure

├── counter-cli/         # CLI tools
├── counter-contract/    # Smart contracts
└── frontend-vite-react/ # React application

🔗 Setup Instructions

Install Project Dependencies and compile contracts

 # From project root
 pnpm install
 pnpm build

Setup Env variables

1. Create .env file from template under counter-cli folder

   • counter-cli/.env_template

2. Create .env file from template under frontend-vite-react folder

   • frontend-vite-react/.env_template

Start Development on Preview / Preprod / Mainnet

# From project root
pnpm dev:frontend

Start Development on Undeployed (standalone) Network

# In one terminal (from project root)
pnpm setup-standalone

# In another terminal (from project root)
pnpm dev:frontend

🧪 Run Tests

Tests live in counter-cli. Run from the project root:

# Standalone (no live network required)
pnpm --filter @eddalabs/counter-cli test-undeployed

# Against the Preview testnet
pnpm --filter @eddalabs/counter-cli test-preview

# Against the Preprod network
pnpm --filter @eddalabs/counter-cli test-preprod

🤖 Claude Code Plugin (optional)

This repo ships with a project-level .claude/settings.json that registers the edda-labs-marketplace and enables the midnight plugin (Midnight-specific skills and helpers for Claude Code).

If you use Claude Code, it will prompt you to trust these project settings the first time you open the repo. Accept the prompt and the plugin installs automatically — no manual marketplace setup needed. If you don't use Claude Code, this is a no-op.

📚 More Documentation

• DEPLOYMENT_PROCEDURE.md — Vercel deployment guide (Git LFS, env vars, build settings).
• educational-material/ — Midnight Sessions video walkthroughs and content plans by Edda Labs.

---

Built with ❤️ by Edda Labs