How innovat3x/brand-intelligence works
Brand Intelligence is an AI-assisted workspace that guides a product idea through discovery, positioning, brand shaping, visual identity, challenge, and a compiled brand kit. Users create and revisit projects, submit stage inputs, and review or edit accumulated brand state; they can also export project details and workflow history. The frontend hooks and API client are sampled, as are project, brand, export, and database services. Backend route-to-service wiring and detailed workflow orchestration are not shown, so those connections are omitted rather than inferred.
Main entry points: main.py FastAPI application · page.tsx Project workspace · api.ts API client · brand_state.py Persistence models
Components 25
Web experience
- Web app
frontend/app/page.tsx - Project workspace
frontend/app/project/[id]/page.tsx - Workflow hook
frontend/hooks/useWorkflow.ts - Brand hook
frontend/hooks/useBrandKit.ts - Project hook
frontend/hooks/useProject.ts - API client
frontend/lib/api.ts
Brand workflow
- Discovery
backend/app/agents/discovery.py - Positioning
backend/app/agents/positioning.py - Brand shaping
backend/app/agents/naming.py - Personality and voice
backend/app/agents/personality.py - Visual identity
backend/app/agents/visualize.py - Brand challenge
backend/app/agents/challenge.py - Brand kit
backend/app/agents/deliver.py
Backend services
- FastAPI application
backend/app/main.py - Project API
backend/app/api/projects.py - Workflow API
backend/app/api/workflow.py - Brand API
backend/app/api/brand.py - Export API
backend/app/api/export.py - Project service
backend/app/services/project_service.py - Brand service
backend/app/services/brand_service.py - Export service
backend/app/services/export_service.py - Workflow engine
backend/app/workflow/graph.py
Project state
- Persistence models
backend/app/models/brand_state.py - Database
backend/app/services/database.py
Other components
- Brand creator
Connections 19
- Brand creator → Web app: uses
- Web app → Project workspace: opens projects
- Project workspace → Project hook: loads project
- Project workspace → Workflow hook: starts stages
- Project workspace → Brand hook: loads brand
- Project hook → API client: requests project
- Workflow hook → API client: starts and lists runs
- Brand hook → API client: reads and saves
- API client → FastAPI application: HTTP requests
- FastAPI application → Project API: dispatches
- FastAPI application → Workflow API: dispatches
- FastAPI application → Brand API: dispatches
- FastAPI application → Export API: dispatches
- Project service → Database: reads and writes
- Brand service → Database: reads and writes
- Export service → Database: reads
- Project service → Persistence models: persists project
- Brand service → Persistence models: persists brand state
- Export service → Persistence models: reads state