Skip to main content

Platform Architecture

Bike4Mind is built as a modern modular TypeScript monorepo, optimized for rapid feature delivery, scalability, and maintainability.

  • Core Technologies The platform is built using industry-standard technologies:

    • React (Next.js) for the front-end application, enabling server-side rendering, routing, and rapid component development.
    • Node.js powers the back-end API layer, using RESTful endpoints and serverless functions.
    • MongoDB serves as the primary document database for flexible, scalable data storage.
    • AWS, deployed and managed via SST (Serverless Stack), underpins all infrastructure using serverless-first principles.

  • Monorepo Structure All components of the platform live in a single, unified monorepo. This allows shared dependencies, easier refactoring, and consistent development patterns across teams. Code is organized into:

    • b4m-core: Contains all shared business logic, types, utilities, permission schemas, and validation rules. This layer abstracts platform logic away from individual services.
    • packages/client: The main web application, implemented in Next.js. This houses all user interfaces, authentication logic, state management, and view-layer utilities.
    • packages/server: Hosts serverless API endpoints (Next.js API routes and AWS Lambda-compatible handlers), middleware definitions, service integrations (e.g., LLM providers, OAuth flows), and backend orchestration logic.

  • Serverless-First & CI/CD The platform architecture embraces serverless-first design:

    • Every service is designed to scale on-demand using AWS Lambda and managed services (e.g., S3, RDS Proxy, API Gateway).
    • CI/CD is powered by SEED, providing full Git-based build/deploy pipelines, one-click rollbacks, and per-environment deployment control.

This architecture ensures:

  • Fast, safe deployments across staging and production
  • Shared logic with clear separation of concerns
  • Rapid onboarding for new developers
  • Scalable infrastructure that supports both SaaS and self-hosted deployments