JSON Configuration | Documentation

Tailor the entire toolkit experience using a simple data-driven approach. No code required for most customizations.

The toolkit is built on a Hybrid Customization Model. By creating a .devconsole.json file in your project's public/ folder, you can define your project's specific business logic, API endpoints, and feature flags.

Note for Next.js Users: If you encounter 400 errors when loading the config file (common with dotfiles and middleware), the toolkit automatically falls back to an API route. Create /api/devconsole-config to serve your config file. See the Troubleshooting section for details.

Configuration Schema

json

{
  "version": "1.0.0",
  "onboardingSteps": [
    { "step": "Signup", "status": "completed", "description": "Verified account" },
    { "step": "Initial Action", "status": "current", "description": "User first step" }
  ],
  "featureFlags": [
    { "id": "ff_ai_v2", "label": "AI Engine V2" },
    { "id": "ff_beta_ui", "label": "New Beta UI" }
  ],
  "plans": [
    { "id": "free", "label": "Free Starter" },
    { "id": "premium", "label": "Premium Pro" }
  ],
  "roles": [
    { "id": "user", "label": "Member" },
    { "id": "admin", "label": "Administrator" }
  ],
  "apiEndpoints": [
    {
      "id": "list-users",
      "name": "List Users",
      "url": "/api/v1/users",
      "method": "GET",
      "category": "Admin",
      "requiresAuth": true
    }
  ]
}

Dynamic Integration

API Tab: Your apiEndpoints will appear automatically in the Explorer sidebar.
Onboarding Tab: Renders the steps exactly as defined in your JSON funnel.
God Mode: Dropdowns for Plans and Roles are populated dynamically from your config.
User Tab: Feature flags are listed and toggleable based on your definitions.

Pro Tip: The toolkit merges this file with its internal defaults. You only need to define what you want to override or add.