A cloud-native SaaS platform that empowers designers and brand teams to generate infinite, on-brand visual assets through AI-assisted workflows—while preserving human creative direction.
🚀 Quick Start • 📚 Documentation • 🎯 Features • 🤝 Contributing
Brand OS is a generative AI creativity platform that transforms static brand guidelines into living, executable systems. It ensures 100% brand adherence across all AI-generated outputs without sacrificing emotional resonance or artistic nuance.
From Static to Dynamic: Convert brand guidelines from PDF documents into intelligent systems that guide AI creativity while keeping human designers in strategic control.
- Intelligent Brand Capture: Structured inputs for logo usage, typography, spatial rules, and emotional keywords
- Visual Doctrine Builder: Define spatial relationships and compositional constraints
- Brand Grammar System: Rule-based constraints that AI follows consistently
- Reference Analysis: AI extracts colors, patterns, and stylistic signatures from example images
- Multi-Model Integration: Google Gemini 3 Pro, OpenAI DALL-E, Meta ImageGen
- Smart Prompt Orchestration: Automatically enriches prompts with brand DNA constraints
- Batch Generation: Create 4-10 variations simultaneously
- Compliance Scoring: Real-time brand adherence analysis (0-100%)
- Visual Workflow Canvas: Assemble inspiration → brand rules → AI prompts → outputs
- Interactive Node System: Image references, style attributes, logic gates
- Prompt Synthesis: Translates mood board elements into detailed creative briefs
- Moodboard Workflow: Interactive canvas for visual storytelling and spatial planning.
- Unified Library: Secure vault for all brand assets, reference images, and kampaign history.
- Smart Profiles: Personalized user profiles with customizable bios and preferences.
- Enterprise-Grade Security: Hardened RLS policies with infinite recursion prevention and role-based access.
- Audit System: AI-powered brand adherence analysis with actionable suggestions
- Bulk Operations: Download, tag, and deploy multiple assets
- Multi-Stage Approval: Designer → Art Director → Deploy workflow
- Platform Integrations: Instagram, LinkedIn, Website, CMS
- Automated Publishing: One-click deployment with notifications
- Status Tracking: Complete approval chain visibility
- Multi-User Workspaces: Role-based access (Admin, Art Director, Designer)
- Real-Time Sync: Live presence and collaboration via WebSockets
- Commenting System: Threaded feedback on assets
- Analytics Dashboard: Brand health, creative velocity, team performance
- Node.js v20.x or higher
- npm v10.x or higher
- Git
# 1. Clone the repository
git clone https://github.com/iDorgham/BrandOS.git
cd BrandOS
# 2. Navigate to web directory
cd web
# 3. Install dependencies
npm install
# 4. Set up environment variables
cp .env.example .env
# Edit .env with your Supabase and API keys
# 5. Start development server
npm run devThe application will be available at http://localhost:5173.
# Supabase
VITE_SUPABASE_URL=https://your-project.supabase.co
VITE_SUPABASE_ANON_KEY=your-anon-key
# AI Services
VITE_GOOGLE_AI_API_KEY=your-gemini-api-key📖 For detailed setup instructions, see the Deployment Guide.
Brand overview with DNA spectrum, recent assets, and quick actions
AI-powered asset generation with brand alignment
Node-based visual workflow for creative direction
Advanced filtering and compliance tracking
| Layer | Technology | Purpose |
|---|---|---|
| Frontend | React 19 + TypeScript | UI framework with type safety |
| Build Tool | Vite 6.2 | Lightning-fast dev server |
| Styling | Tailwind CSS 3.4 | Utility-first CSS framework |
| AI Ops | .agents / AGENTS.md | Unified AI workspace & protocols |
| Backend | Supabase (PostgreSQL) | Managed database with RLS |
| Auth | Google OAuth 2.0 | Secure authentication |
| Storage | Supabase Storage | Asset management |
| Realtime | Supabase Realtime | Live collaboration |
| AI | Gemini 3 Pro, DALL-E 4 | Multi-model AI generation |
| Document | Description |
|---|---|
| API Documentation | Complete API reference with endpoints and WebSocket events |
| User Guide | Step-by-step instructions for all features |
| Deployment Guide | Local development and production deployment |
| Technical Architecture | System design and database schema |
| Contributing Guide | Development workflow and coding standards |
| Product Requirements | Comprehensive PRD with roadmap |
- Scale Creative Output: Generate hundreds of brand-aligned assets in minutes
- Client Presentations: Interactive mood boards for creative direction
- Brand Consistency: Ensure all deliverables meet brand standards
- Reduce Bottlenecks: Empower designers to work faster with AI assistance
- Campaign Velocity: Rapid iteration and A/B testing of creative concepts
- Brand Governance: Enforce brand guidelines across all outputs
- Professional Quality: Create agency-level assets without the cost
- Brand Evolution: Update and refine brand DNA as you grow
- Cost Efficiency: 60% reduction in asset creation costs
Version: 2.0 (Production Ready)
Status: ✅ Fully Deployed
| Phase | Status | Features |
|---|---|---|
| Phase 1 | ✅ Complete | Brand Profile Engine, Creative Studio, Asset Library |
| Phase 1.5 | ✅ Complete | Smart prompts, reference analysis, data persistence |
| Phase 2 | ✅ Complete | Mood boards, multi-model AI, deployment hub |
| Phase 3 | ✅ Complete | Workspaces, real-time sync, analytics |
We welcome contributions! Please see our Contributing Guide for details on:
- Development workflow
- Coding standards
- Commit guidelines
- Pull request process
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'feat: add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
| Metric | Target | Current |
|---|---|---|
| First Contentful Paint | < 1.5s | 1.2s ⚡ |
| Time to Interactive | < 3.5s | 2.8s ⚡ |
| Bundle Size | < 500KB | 412KB 📦 |
| Lighthouse Score | > 90 | 94 🎯 |
- Row Level Security (RLS): Data isolation at the database level
- OAuth 2.0: Secure Google authentication
- HTTPS Only: All production traffic encrypted
- API Key Management: Environment-based secret handling
For security concerns, please email: security@brandos.app
This project is licensed under the MIT License - see the LICENSE file for details.
- Google Gemini for advanced AI capabilities
- Supabase for robust backend infrastructure
- Vercel for seamless deployment
- Open Source Community for amazing tools and libraries
- Documentation: docs.brandos.app
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: support@brandos.app
Built with ❤️ by creative technologists, for creative professionals
⭐ Star this repository if you find it helpful!