Skip to content

BlackRoad-Forge/blackroad-os-monorepo

ulackroad os monorepo

Part of BlackRoad OS — Sovereign Computing for Everyone

BlackRoad OS BlackRoad-Forge

ulackroad os monorepo is part of the BlackRoad OS ecosystem — a sovereign, distributed operating system built on edge computing, local AI, and mesh networking by BlackRoad OS, Inc.

BlackRoad Ecosystem

Org Focus
BlackRoad OS Core platform
BlackRoad OS, Inc. Corporate
BlackRoad AI AI/ML
BlackRoad Hardware Edge hardware
BlackRoad Security Cybersecurity
BlackRoad Quantum Quantum computing
BlackRoad Agents AI agents
BlackRoad Network Mesh networking

Website: blackroad.io | Chat: chat.blackroad.io | Search: search.blackroad.io


Turborepo-based monorepo for the BlackRoad OS platform — web apps, backend services, shared packages, and infrastructure configs.

Structure

apps/
  web/              # Marketing site + dashboard (Next.js 14)
  ai-dashboard/     # AI agent monitoring (Next.js)
  console/          # Prism Console (Next.js)
services/
  api/              # API Gateway (Node.js)
  auth/             # Authentication
  billing/          # Subscriptions
  analytics/        # Analytics pipeline
packages/
  shared/           # Common utilities
  ui/               # Design system components
  config/           # Shared configs
  types/            # TypeScript definitions
  agent-sdk/        # Agent development SDK
infrastructure/
  cloudflare/       # Workers, KV, R2, D1
  railway/          # Railway service configs
  raspberry-pi/     # Local LLM deployment
tooling/
  cli/              # BlackRoad CLI
  scripts/          # Automation

Quick Start

pnpm install
pnpm dev          # Run all services
pnpm build        # Build all packages
pnpm test         # Run tests

Work on a specific app

cd apps/web && pnpm dev
turbo run build --filter=@blackroad/web...

Stack

  • Build: Turborepo + pnpm workspaces
  • Frontend: Next.js 14 (App Router), React
  • Backend: Node.js microservices
  • Edge: Cloudflare Workers, Pages, KV, R2, D1
  • Compute: Railway, Raspberry Pi cluster
  • Messaging: NATS (pub/sub)

Deploy

pnpm deploy:cloudflare    # Edge + static
pnpm deploy:railway       # Backend services

Turborepo only builds changed packages and their dependents:

turbo run build --filter=[HEAD^1]

Packages

All packages use the @blackroad/<name> convention with independent versioning.

License

Copyright 2026 BlackRoad OS, Inc. All rights reserved.

About

BlackRoad OS Monorepo — Unified codebase for BlackRoad OS platform and services.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors