An AI-Powered Open-Source Mock API Server that enables users to self-host, manage, and run mock APIs with ease.

Try it out at https://mocknica.dev

Stop waiting for backend APIs. Mocknica empowers frontend developers and teams to build and test applications without backend dependencies.

• ⚡ Instant REST Endpoints - Instantly generate REST endpoints you can call from any client
• 📝 Schema-Based Design - Define reusable data schemas and auto-generate complete CRUD endpoints
• 🤖 AI-Powered Generation - Generate schemas and endpoints using LLM like GPT, Gemini, or local Ollama models
• 📦 Response Wrappers - Customize response structure with reusable wrapper templates
• 📊 Multi-Project Support - Organize mock APIs by project with isolated endpoints and configurations
• 🔐 Token Authentication - Secure your mock APIs with Bearer token authentication
• 🌐 CORS Configuration - Configure allowed origins for browser requests

Mocknica is built with modern and reliable technologies:

Mocknica uses a Turborepo-powered monorepo architecture for better code organization, shared configurations, and efficient builds with caching.

mocknica/
├── apps/
│   ├── dashboard/          # Main Next.js application
│   │   ├── app/            # App router pages & API routes
│   │   ├── components/     # React components
│   │   ├── lib/            # Utilities, services, repositories, auth
│   │   └── prisma/         # Database schema & migrations
│   └── www/                # Landing page / Marketing website
├── packages/
│   ├── ui/                 # Shared UI component library
│   ├── eslint-config/      # Shared ESLint configurations
│   └── tsconfig/           # Shared TypeScript configurations
├── docker-compose.yml      # Docker orchestration
├── turbo.json              # Turborepo configuration
└── pnpm-workspace.yaml     # pnpm workspace config

• Node.js v18+
• pnpm v10+
• Docker (for database & Redis)

1. Clone and install

   git clone https://github.com/eren1106/mocknica.git
   cd mocknica
   pnpm install

2. Configure environment

   cp apps/dashboard/.env.example apps/dashboard/.env

   Add your database, AI provider, and Redis credentials:

    # Database (required)
    DATABASE_URL="postgresql://postgres:postgres@localhost:5432/mocknica"
   
    # AI Providers (at least one recommended)
    GEMINI_API_KEY="your-gemini-key"          # Free tier available
    OPENAI_API_KEY="sk-..."                   # Optional
    OLLAMA_BASE_URL="http://localhost:11434"  # Optional
   
    # Optional: Rate Limiting (recommended for production)
    REDIS_URL="http://localhost:8079"         # Local via proxy, or Upstash URL
    REDIS_TOKEN="example_token"

3. Better Auth Setup

   Generate a secure secret for authentication:

   openssl rand -hex 32

   Add the generated secret to your .env file:

   BETTER_AUTH_SECRET=your_generated_secret_here
   BETTER_AUTH_URL="http://localhost:3000"

4. Google OAuth Setup (Optional - for Google sign-in)

   • Go to Google Cloud Console

   • Create a new project (or select an existing one)

   • Navigate to APIs & Services > OAuth consent screen

     • Configure the consent screen (External or Internal based on your needs)
     • Add your email as a test user during development

   • Navigate to APIs & Services > Credentials

     • Click Create Credentials > OAuth client ID
     • Select Web application as the application type
     • Add authorized redirect URIs:
       • Development: http://localhost:3000/api/auth/callback/google
       • Production: https://your-domain.com/api/auth/callback/google

   • Add the credentials to your .env file:

     GOOGLE_CLIENT_ID=your_client_id
     GOOGLE_CLIENT_SECRET=your_client_secret

   Note: During development, add yourself as a test user in the OAuth consent screen under Test users.

5. Setup database

   pnpm docker:db
   pnpm db:sync

   For rate limiting, also start Redis and proxy:

   docker-compose up redis serverless-redis-http -d

6. Start developing

   pnpm dev

   Open http://localhost:3000 to get started.

Deploy the complete stack with a single command:

# Start all services (app, database, Redis)
pnpm docker:up

# Sync database
pnpm db:sync

Once created, your mock APIs are instantly available:

# Get all items
curl http://localhost:3000/api/mock/{project-id}/users

# Get single item
curl http://localhost:3000/api/mock/{project-id}/users/123

# Create item
curl -X POST http://localhost:3000/api/mock/{project-id}/users \
  -H "Content-Type: application/json" \
  -d '{"name": "John Doe", "email": "[email protected]"}'

# With authentication
curl http://localhost:3000/api/mock/{project-id}/users \
  -H "Authorization: Bearer your-project-token"

We welcome contributions! Here's how to get started:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes
4. Run tests: pnpm test
5. Commit your changes: git commit -m 'Add amazing feature'
6. Push to the branch: git push origin feature/amazing-feature
7. Open a Pull Request

• Use GitHub Issues for bug reports
• Include reproduction steps and environment details
• Check existing issues before creating new ones