ShipAI Docs
Recipes

Minimal Local Mode

Run only required local services and disable optional features for fast development loops.

This recipe gives you a fast, low-resource local setup focused on core chat + auth + file upload paths.

Intentional feature reduction

Minimal mode is optimized for fast iteration, not full product parity. Search/deep-search/memory paths are intentionally disabled.

Workflow

Start required services

docker compose up postgres redis minio createbuckets maildev -d

Set minimal env toggles

Update apps/app/.env:

FEATURE_SEARCH_ENABLED=false
FEATURE_DEEP_SEARCH_ENABLED=false
FEATURE_MEMORY_ENABLED=false

SERVICE_SEARXNG_AVAILABLE=false
SERVICE_QDRANT_AVAILABLE=false
SERVICE_NEO4J_AVAILABLE=false

DEVELOPMENT_MODE=true

Run migration and seed

bun db:migrate
bun db:seed:plans

Start app and validate

bun dev:app
bun health

Expected behavior in minimal mode:

  • works: auth, basic AI chat (requires provider API key), uploads via MinIO
  • disabled by design: web search, deep search, memory graph/vector features
  • billing limits not enforced when DEVELOPMENT_MODE=true

Rebrand the Product

Rebrand app identity, AI identity, and baseline visual settings via env-driven configuration.

Add a New Feature Module

Create a new shared package in the monorepo and roll it out safely with feature flags.

On this page

WorkflowStart required servicesSet minimal env togglesRun migration and seedStart app and validate