Transform rough ideas into coherent, launch-ready brand systems through a structured 11-stage AI workflow.
Founders, creators, and teams often start with a rough idea but struggle to translate it into a cohesive brand strategy. They face:
- Unclear positioning and differentiation
- Generic naming and messaging
- Inconsistent visual identity
- No systematic approach to brand development
- Expensive agency fees for early-stage work
Inkloom is an AI-powered brand intelligence platform that guides users through a structured 11-stage workflow, transforming a rough idea into a complete brand kit with positioning, naming, visual identity, messaging, and launch content.
- Discover - AI interview to deeply understand your idea
- Position - Define category, audience, value proposition, differentiation
- Personality - Select 4-5 brand traits with rationale
- Naming - Generate 15+ names across multiple territories
- Messaging - Craft taglines, pitches, and message hierarchy
- Visual - Define colors, typography, logo concept, imagery style
- Critique - AI critic detects clichΓ©s, weaknesses, contradictions
- Consistency - Cross-check all elements for alignment
- Voice - Define brand voice and write sample copy
- Launch - Generate complete launch content kit
- Brand Kit - Polished, exportable final deliverable
- Human-in-the-loop: Review, edit, regenerate, or accept at every stage
- Structured context: Each stage receives structured data from previous stages
- Decision history: Track every brand decision with timestamps
- Export/Download: Markdown and text export of brand kit
- Responsive design: Works on desktop and mobile
- JWT Authentication: Secure user accounts with protected routes
project-root/
βββ frontend/ # React + Vite + Tailwind CSS
β βββ src/
β β βββ components/ # Reusable UI components
β β βββ pages/ # Page components
β β βββ layouts/ # Layout components
β β βββ services/ # API service layer
β β βββ hooks/ # Custom React hooks
β β βββ context/ # React context providers
β β βββ utils/ # Utility functions
β β βββ App.jsx # Main app with routing
β β βββ main.jsx # Entry point
β β βββ index.css # Global styles + Tailwind
β βββ package.json
β
βββ backend/ # Node.js + Express + Prisma
β βββ src/
β β βββ config/ # Configuration management
β β βββ controllers/ # Request handlers
β β βββ middleware/ # Express middleware
β β βββ routes/ # API route definitions
β β βββ services/ # Business logic & AI services
β β β βββ ai/ # Modular AI services per stage
β β βββ utils/ # Utility functions
β β βββ validators/ # Zod validation schemas
β β βββ app.js # Express app setup
β β βββ server.js # Server entry point
β βββ prisma/
β β βββ schema.prisma # Database schema
β βββ package.json
β
βββ README.md
ROUGH IDEA
β
DISCOVERY (AI Interview β Structured Profile)
β
POSITIONING (Category, Audience, Value Prop, Differentiator)
β
PERSONALITY (4-5 Traits + Traits to Avoid)
β
NAMING (15+ Names across 4-5 Territories β Select ONE)
β
MESSAGING (Taglines, Pitches, Hierarchy β Select Tagline)
β
VISUAL (Colors, Typography, Logo, Imagery)
β
CRITIQUE (Detect Issues β Apply/Ignore/Edit)
β
CONSISTENCY (Cross-check All Elements β Apply Fixes)
β
VOICE (Characteristics, Tone, Sample Copy)
β
LAUNCH (Landing Page, Social Posts, Founder Pitch)
β
FINAL BRAND KIT (Complete Exportable Deliverable)
Each stage:
- Receives structured context from previous stages
- Generates structured JSON via LLM
- Allows user to edit, regenerate, or accept
- Saves approved decisions to database
- Passes approved data to next stage
- React 18 - UI framework
- Vite - Build tool & dev server
- React Router v6 - Client-side routing
- Tailwind CSS - Utility-first styling
- Lucide React - Icon library
- Axios - HTTP client
- React Hot Toast - Notifications
- date-fns - Date formatting
- clsx + tailwind-merge - Class name utilities
- Node.js - Runtime
- Express.js - Web framework
- Prisma ORM - Database ORM
- PostgreSQL - Primary database
- JWT - Authentication
- bcryptjs - Password hashing
- Zod - Input validation
- OpenAI SDK - LLM integration (compatible with OpenAI API)
Each stage has a dedicated service:
discoveryService.js- AI interview & profile generationpositioningService.js- Positioning strategypersonalityService.js- Brand personality traitsnamingService.js- Name generation across territoriesmessagingService.js- Messaging frameworkvisualService.js- Visual identity directioncriticService.js- AI brand criticconsistencyService.js- Consistency guardianvoiceService.js- Brand voice & copylaunchService.js- Launch content kit
- User - Authentication (id, name, email, passwordHash)
- Project - Brand project (name, roughIdea, status, currentStage)
- Discovery - Core problem, audiences, needs, goals, constraints
- Positioning - Category, audience, value prop, differentiator, statement
- BrandPersonality - Traits (with why/how), traits to avoid
- Naming - Territories with names, selected name + rationale
- Messaging - Taglines, pitches, hierarchy, selected tagline
- VisualDirection - Logo, typography, colors, imagery style
- Critique - Issues with severity, problem, suggestion, alternative
- ConsistencyCheck - Cross-element checks, overall score
- BrandVoice - Characteristics, tone, vocabulary, sample copy
- LaunchKit - Landing page, social posts, founder pitch
- BrandKit - Final deliverable marker
- DecisionHistory - Audit trail of all decisions
User 1βββ Project
Project 1ββ1 Discovery
Project 1ββ1 Positioning
Project 1ββ1 BrandPersonality
Project 1ββ1 Naming
Project 1ββ1 Messaging
Project 1ββ1 VisualDirection
Project 1ββ1 Critique
Project 1ββ1 ConsistencyCheck
Project 1ββ1 BrandVoice
Project 1ββ1 LaunchKit
Project 1ββ1 BrandKit
Project 1βββ DecisionHistory
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/auth/register |
Register new user |
| POST | /api/auth/login |
Login user |
| GET | /api/auth/me |
Get current user |
| POST | /api/auth/logout |
Logout (client-side) |
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/projects |
List user's projects |
| POST | /api/projects |
Create new project |
| GET | /api/projects/:id |
Get project with all stages |
| PUT | /api/projects/:id |
Update project |
| DELETE | /api/projects/:id |
Delete project |
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/projects/:id/discovery/interview |
AI interview questions |
| POST | /api/projects/:id/discovery/generate |
Generate discovery profile |
| POST | /api/projects/:id/discovery |
Save discovery profile |
| POST | /api/projects/:id/positioning/generate |
Generate positioning |
| POST | /api/projects/:id/positioning |
Save positioning |
| POST | /api/projects/:id/personality/generate |
Generate personality |
| POST | /api/projects/:id/personality |
Save personality |
| POST | /api/projects/:id/naming/generate |
Generate names |
| POST | /api/projects/:id/naming |
Save selected name |
| POST | /api/projects/:id/messaging/generate |
Generate messaging |
| POST | /api/projects/:id/messaging |
Save messaging |
| POST | /api/projects/:id/visual/generate |
Generate visual direction |
| POST | /api/projects/:id/visual |
Save visual direction |
| POST | /api/projects/:id/critique/generate |
Generate critique |
| POST | /api/projects/:id/critique |
Save critique |
| POST | /api/projects/:id/critique/apply |
Apply critique action |
| POST | /api/projects/:id/consistency/generate |
Generate consistency check |
| POST | /api/projects/:id/consistency |
Save consistency |
| POST | /api/projects/:id/consistency/apply |
Apply consistency fix |
| POST | /api/projects/:id/voice/generate |
Generate brand voice |
| POST | /api/projects/:id/voice |
Save brand voice |
| POST | /api/projects/:id/launch/generate |
Generate launch kit |
| POST | /api/projects/:id/launch |
Save launch kit |
| GET | /api/projects/:id/brand-kit |
Get complete brand kit |
- Node.js 18+
- PostgreSQL 14+
- npm or yarn
- Clone and navigate to project
cd INKLOOM- Backend setup
cd backend
cp .env.example .env
# Edit .env with your configurationRequired environment variables in backend/.env:
# Database
DATABASE_URL="postgresql://USERNAME:PASSWORD@localhost:5432/brand_intelligence"
# JWT
JWT_SECRET="your_super_secret_jwt_key_change_in_production"
JWT_EXPIRES_IN="7d"
# AI Configuration (OpenAI compatible)
AI_API_KEY="your_ai_api_key"
AI_MODEL="gpt-4o-mini"
AI_BASE_URL="https://api.openai.com/v1"
# Server
PORT=5000
FRONTEND_URL="http://localhost:5173"
NODE_ENV="development"- Install backend dependencies
npm install- Set up database
# Generate Prisma client
npm run prisma:generate
# Run migrations
npm run prisma:migrate
# Or push schema directly (development)
npm run prisma:push- Frontend setup
cd ../frontend
npm installTerminal 1 - Backend:
cd backend
npm run dev
# Server runs on http://localhost:5000Terminal 2 - Frontend:
cd frontend
npm run dev
# Frontend runs on http://localhost:5173# Generate Prisma client after schema changes
npm run prisma:generate
# Create and run migration
npm run prisma:migrate
# Push schema without migration (dev only)
npm run prisma:push
# Open Prisma Studio (database GUI)
npm run prisma:studio
# Seed database (if seed script exists)
npm run prisma:seed- Password Hashing: bcrypt with 12 rounds
- JWT Authentication: Secure tokens with expiration
- Protected Routes: All project APIs require authentication
- Authorization: Users can only access their own projects
- Input Validation: Zod schemas on all endpoints
- Parameterized Queries: Prisma prevents SQL injection
- CORS: Configured for frontend origin only
- Environment Variables: All secrets in
.env(never committed) - No Frontend Secrets: AI API key only on backend
# Backend tests (when implemented)
cd backend
npm test
# Frontend tests (when implemented)
cd frontend
npm test- Set
NODE_ENV=production - Use strong
JWT_SECRET - Configure production
DATABASE_URL - Set
AI_API_KEYfor production - Run
npm run prisma:migrate deploy - Start with
npm start
- Build:
npm run build - Serve
dist/folder with nginx, Vercel, Netlify, etc. - Configure API proxy or set
VITE_API_URL
# Backend Dockerfile
FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --
COPY . .
RUN npx prisma generate
EXPOSE 5000
CMD ["npm", "start"]- Modern SaaS Design: Clean, professional, hackathon-ready
- Responsive Layout: Mobile-first with sidebar navigation
- Progress Indicators: Visual stage completion tracking
- Loading States: Skeletons and spinners for AI operations
- Toast Notifications: Success/error feedback
- Accessible: Semantic HTML, ARIA labels, keyboard navigation
- Color System: Brand + Ink color palettes with dark mode support
All AI services return validated JSON with:
- Strict schema definitions
- Automatic parsing with fallback strategies
- Retry logic for failed requests
- Error handling for malformed responses
Each stage receives exactly what it needs:
- Naming: Discovery + Positioning + Personality
- Critique: Complete brand system so far
- Consistency: All approved brand elements
- Launch: Final approved brand system
Compatible with any OpenAI-compatible API:
- OpenAI (GPT-4o, GPT-4o-mini)
- Anthropic (via proxy)
- Local models (Ollama, vLLM)
- Azure OpenAI
- Fork the repository
- Create feature branch:
git checkout -b feature/amazing-feature - Commit changes:
git commit -m 'Add amazing feature' - Push to branch:
git push origin feature/amazing-feature - Open a Pull Request
MIT License - Built for the Inkloom Hackathon
- Built for the Inkloom Hackathon
- Inspired by brand strategy frameworks
- Powered by modern AI and web technologies
Ready to build your brand? Run the application and start transforming your ideas into memorable brands!