Busflow

Internal Developer Entry Point — Single entry point for humans and AI agents. Domain-specific rules and learnings live in .agents/skills/.

Busflow is a SaaS platform for DACH bus tourism operators. This monorepo contains all applications, shared libraries, infrastructure, and documentation.

Prerequisites

Before starting, ensure you have the following installed on your machine:

• Node.js (v20+) & pnpm (v9+)
• Docker & Docker Compose

Quick Start

Boot all primary projects via Turborepo with a single command:

pnpm install
pnpm dev

For all other development commands (e.g., workspace only, landing page, Hasura CLI), see the CLI Cheatsheet.

Architecture & Tech Stack

• Core: Vue 3, Hasura (GraphQL), PostgreSQL, NestJS, Nhost, Docker on Hetzner.
• For an exhaustive breakdown of libraries and architectural decisions, see the Tech Stack Reference.
• To view deployment details and topologies, refer to the CI/CD & Observability Docs.

Environments

Environment	URL
Production	busflow.app
Docs	docs.busflow.app
Monitoring	grafana.busflow.app
PR Previews	pr-<N>.preview.busflow.app

For the full endpoint-to-workflow mapping, see the Production Service Map.

Repository Structure

The monorepo is structured logically to separate concerns:

• apps/ — Product applications (e.g., workspace, passenger, driver)
• packages/ — Shared libraries (e.g., core, ui-domain)
• infrastructure/ — Terraform and Docker Compose configs
• docs/ — PARA-structured documentation (1-projects/, 2-areas/, etc.)

For comprehensive navigation and architectural specifications, visit the Busflow Docs Hub.

Contributing & Rules

• Code Standards: Use Conventional Commits (feat:, fix:). Prefer self-documenting code and structural outputs (JSON, YAML).
• AI Agents: All domain-specific instructions, security rules, and workflows are located in .agents/skills/. Agents MUST consult these skills before making architectural changes.
• Forbidden Actions: Never execute destructive infrastructure commands (terraform destroy), database truncations (DROP TABLE), force git pushes to main, or secret exposures without explicit human approval.