Adaptive Socratic Brand Architect & Design Token Synthesizer
Formulate defensible positioning, verbal identity, and production-ready design tokens powered by Groq & Google Gemini.
Founders often struggle to articulate their brand identity, settling for generic copy, safe aesthetics, and cookie-cutter templates. BrandLoom breaks this paradigm using an un-templated Socratic Brand Interviewer:
- Instant Static Sample Preview: Jump straight into an editorial brand monograph for "Blister & Beam" (Wood-Fired Sourdough) with 1 click. Zero backend API calls, zero LLM tokens, and 100% exempt from the 2-run guest limit.
- Strategic Refinement Gate: Evaluates raw founder inputs, rejects gibberish/spam, and formulates 2 contrasting commercial directions tailored to that exact business premise.
- Adaptive 7-Question Socratic Discovery Engine: Formulates seven highly customized, non-generic strategic questions (e.g. Cast-Iron Ritual, Sourdough Stance, Cap Ergonomics, Usage Context) with dynamic stage labels, grounding choices in category-specific realities with zero software jargon or demographic caricatures.
- Brand Kit & Monograph Synthesis: Distills the dynamic discovery transcript into structured design tokens:
- Brand Strategy: Mission, Anti-Hero Villain, Core Value Proposition, Differentiator ("Onlyness Test").
- Voice System: Archetype, Tone Adjectives, Dos & Don'ts, Signature Lexicon.
- Visual Tokens: Contrast-checked HSL/HEX palettes (warm cream & parchment canvases for food/CPG; dark mode reserved for nocturnal developer tooling), dynamic Google Fonts pairing, curvature, and style philosophy.
- Website Blueprint: Sections, SKU grids, comparative ledgers, and hero CTAs.
- Launch Content: Manifesto, Hero Headlines, Elevator Pitch, Viral Social Hooks.
- Interactive Website Simulator: Real-time mobile & desktop viewports with zero horizontal scroll overflow.
- MVP "AI Prompts" Suite: Export 1-click production-ready master prompts containing all Q&A context, design tokens, and component blueprints directly into Lovable, Bolt.new, Google Antigravity, v0, or ChatGPT/Claude.
- Frontend: React 18, Vite, Tailwind CSS, Lucide React Icons, Google Fonts API.
- Backend: Node.js, Express, MongoDB Atlas (Mongoose), JWT, Google OAuth 2.0.
- LLM Engine: Groq SDK (
qwen/qwen3.8-27b,openai/gpt-oss-20b,llama-3.3) + Google Gemini SDK (@google/genai) with automatic multi-model failover. - Data Contracts: TypeScript Interfaces (
client/src/types/brand.ts) & Gemini Structured JSON Schemas.
BrandLoom is pre-configured for seamless single-click full-stack deployment on Vercel using vercel.json and Vercel Serverless Functions (api/index.js).
# 1. Install Vercel CLI
npm install -g vercel
# 2. Deploy from repository root
vercel- Push your code to GitHub / GitLab / Bitbucket.
- Go to Vercel Dashboard
$\rightarrow$ Import Project. - Select your repository.
- Configure Project Settings:
- Framework Preset: Vite
-
Root Directory:
./ -
Build Command:
cd client && npm run build(or leave default) -
Output Directory:
client/dist
- Add Environment Variables in the Vercel Settings panel (see table below).
- Click Deploy.
Add the following environment variables to your Vercel Project under Settings
| Variable Name | Required? | Category | Description & Example Value |
|---|---|---|---|
GROQ_API_KEY |
Recommended | LLM Engine | Groq API Key for ultra-fast Socratic discovery & synthesis. Get yours at console.groq.com. gsk_... |
LLM_PROVIDER |
Optional | LLM Engine | Primary provider selection (groq or gemini). Default: groq. |
GEMINI_API_KEY |
Optional | LLM Engine | Google Gemini API Key for fallback LLM requests. Get yours at aistudio.google.com. AIzaSy... |
GEMINI_MODEL |
Optional | LLM Engine | Gemini model ID. Default: gemini-2.5-flash. |
MONGODB_URI |
Recommended | Database | MongoDB Atlas connection string for saving user sessions & brand library. mongodb+srv://user:pass@cluster.mongodb.net/brandloom?retryWrites=true |
JWT_SECRET |
Required | Auth | Secret string used for signing JWT authentication tokens. brandloom-jwt-secret-key-2026 |
CLIENT_URL |
Optional | CORS | Deployed frontend domain. Vercel automatically accepts *.vercel.app subdomains. https://brandloom.vercel.app |
GOOGLE_CLIENT_ID |
Optional | OAuth | Google OAuth 2.0 Client ID for 1-click Google Sign In. 281883142806-....apps.googleusercontent.com |
GOOGLE_CLIENT_SECRET |
Optional | OAuth | Google OAuth 2.0 Client Secret. GOCSPX-.... |
VITE_GOOGLE_CLIENT_ID |
Optional | Client OAuth | Client-side Google Client ID (same value as GOOGLE_CLIENT_ID). |
VITE_API_URL |
Optional | Client API | Base API URL. On Vercel, leave empty ("") to use relative same-origin /api. |
Offline Demo Mode: If no LLM keys are supplied, BrandLoom automatically activates high-fidelity domain-adaptive mock engines for zero-crash demonstrations!
# Install root, server, and client dependencies
npm run install:allCopy .env.example to server/.env:
cp .env.example server/.envnpm run dev- Client:
http://localhost:5173 - Backend:
http://localhost:5001
npm testVerifies restaurant and denim brand synthesis pipelines, ensuring 100% category purity and zero dark-mode obsidian bias for food/CPG.
- Free Static Sample Preview: Instant 1-click access to the comprehensive "Blister & Beam" wood-fired sourdough monograph (0 LLM tokens, 100% free, decoupled from guest quotas).
- Strategic Intake: Raw input expansion into 2 commercial angles with anti-spam validation gate.
- Adaptive Socratic Discovery: 7 dynamically generated question dimensions with 3 high-signal choices.
- Brand Kit Monograph: Interactive typography rationale, color swatches, manifesto, and copy guidelines.
- Live Device Preview: Toggle desktop and mobile viewports with clean surface contrast and zero horizontal scroll overflow.
- ✨ AI Prompts Modal: 1-click copy master prompts for Lovable & Bolt.new, Google Antigravity & v0, and ChatGPT/Claude.
- Print & PDF Dossier: Clean, printable executive brand monograph stylesheet (
@media print). - Brand Library Archive: Save, load, and manage created brand monographs with MongoDB Atlas persistence.
MIT © 2026 BrandLoom Team. Strategic Positioning, Verbal Identity & Design Systems.