GETTING STARTED

INSTALLATION

Set up MantleDevKit for local development or self-hosting.

REQUIREMENTS

  • Node.js 18.0 or later
  • npm, yarn, or pnpm package manager
  • Git (for cloning the repository)

CLONE THE REPOSITORY

TERMINAL
git clone https://github.com/your-username/MantleDevKit.git
cd MantleDevKit

INSTALL DEPENDENCIES

TERMINAL
npm install

This installs all dependencies for the monorepo, including the web app and all packages.

CONFIGURE ENVIRONMENT

Create a .env.local file in the apps/web directory with the following variables:

apps/web/.env.local
# Required: WalletConnect Project ID
# Get one at https://cloud.walletconnect.com
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your_project_id

# Optional: Custom RPC endpoints
NEXT_PUBLIC_MANTLE_RPC_URL=https://rpc.mantle.xyz
NEXT_PUBLIC_MANTLE_SEPOLIA_RPC_URL=https://rpc.sepolia.mantle.xyz

# Optional: Explorer API key for verification
NEXT_PUBLIC_MANTLE_EXPLORER_API_KEY=your_api_key

START DEVELOPMENT SERVER

TERMINAL
npm run dev

The application will be available at http://localhost:3000

BUILD FOR PRODUCTION

TERMINAL
npm run build
npm run start

PROJECT STRUCTURE

MantleDevKit/
├── apps/
│   └── web/              # Next.js web application
│       ├── app/          # App router pages
│       ├── components/   # React components
│       └── lib/          # Utilities
├── packages/
│   ├── ai/               # AI generation (Gemini, OpenAI, Claude)
│   ├── compiler/         # Solidity compiler & templates
│   ├── storage/          # IndexedDB & localStorage
│   └── ui/               # Shared UI components
├── turbo.json            # Turborepo configuration
└── package.json

NEXT STEPS