a0c031ea0a
Reduces schedule from every 30min to daily (saves minutes). Creates a PR branch for dependency updates instead of pushing to main.
🌌 BlackRoad OS Web
Production-grade Next.js application with 5 quantum domains - Full-stack BlackRoad OS web platform with official brand design system.
🌐 Live Deployments
This application serves 5 quantum domains:
- blackroad.io - Primary domain
- blackroadai.com - AI-focused portal
- blackroadquantum.com - Quantum computing interface
- lucidia.earth - Companion AI platform
- earth.blackroad.io - Earth visualization
✨ Features
- Next.js 15 - Latest App Router architecture
- TypeScript - Full type safety
- Brand Compliant - Official BlackRoad design system
- Authentication - Secure login/signup flows
- Workspace - Multi-domain workspace interface
- Real-time - Conversation and collaboration features
- Responsive - Mobile-first design
🎨 Brand Compliance
✅ OFFICIAL BlackRoad Brand Design System Integrated:
- Hot Pink (#FF1D6C) primary color
- Golden Ratio spacing (φ = 1.618): 8px, 13px, 21px, 34px, 55px, 89px, 144px
- SF Pro Display typography
- Line height: 1.618 (Golden Ratio)
- Official gradient: 135deg @ 38.2% & 61.8%
- No forbidden old colors
See app/globals.css for complete brand system implementation.
🚀 Getting Started
Prerequisites
- Node.js 18+ or Bun
- npm, yarn, pnpm, or bun
Installation
# Clone the repository
git clone https://github.com/BlackRoad-OS/blackroad-os-web.git
cd blackroad-os-web
# Install dependencies
npm install
# or
bun install
# Run development server
npm run dev
# or
bun dev
Open http://localhost:3000 to see the application.
📁 Project Structure
blackroad-os-web/
├── app/ # Next.js App Router
│ ├── (app)/ # Authenticated app routes
│ │ ├── workspace/ # Main workspace
│ │ └── conversations/ # Chat interface
│ ├── (auth)/ # Authentication routes
│ │ ├── login/ # Login page
│ │ └── signup/ # Signup page
│ ├── globals.css # 🌌 OFFICIAL BRAND SYSTEM
│ └── layout.tsx # Root layout
├── components/ # React components
├── stores/ # Zustand state management
├── lib/ # Utilities
└── public/ # Static assets
🔧 Development
# Development server
npm run dev
# Production build
npm run build
# Start production server
npm start
# Lint code
npm run lint
# Type check
npm run type-check
🚢 Deployment
Cloudflare Pages (Recommended)
# Build for production
npm run build
# Deploy with Wrangler
wrangler pages deploy ./out --project-name=blackroad-os-web
Automatic Deployment
Push to main branch triggers automatic deployment via GitHub Actions (if configured).
🔐 Environment Variables
Create .env.local:
# Required
NEXT_PUBLIC_API_URL=https://api.blackroad.io
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_key
# Optional
NEXT_PUBLIC_ANALYTICS_ID=your_analytics_id
📊 Performance
- Lighthouse Score Target: >90
- First Contentful Paint: <1.5s
- Time to Interactive: <3s
- Core Web Vitals: All Green
🔒 Security
- HTTPS enforced across all domains
- Security headers configured
- CSP (Content Security Policy)
- XSS protection
- CORS properly configured
- Environment variables for secrets
🧪 Testing
# Unit tests (when configured)
npm run test
# E2E tests (when configured)
npm run test:e2e
📚 Tech Stack
- Framework: Next.js 15 (App Router)
- Language: TypeScript
- Styling: Tailwind CSS + Official Brand System
- State: Zustand
- Deployment: Cloudflare Pages
- CI/CD: GitHub Actions
🤝 Contributing
This is a production repository serving 5 live domains. All changes require:
- GitHub issue or approved task
- Pull request with comprehensive description
- Brand compliance verification
- All tests passing
- Code review approval
- No breaking changes to live domains
📄 License
Copyright © 2026 BlackRoad OS, Inc. All rights reserved.
See LICENSE for details.
🔗 Related Projects
📖 Documentation
💬 Support
- Issues: GitHub Issues
- Email: blackroad.systems@gmail.com
Built with ❤️ by BlackRoad OS Team | blackroad.io | Powering 5 quantum domains