Busflow

The AI operating system for bus tourism. — More buses on the road. Less paper on the desk.

Busflow is a verticalized AI-SaaS platform that replaces the outdated IT landscape of SMB bus tour operators in the DACH region. From AI-powered tour planning and conversion-optimized checkout to real-time dispatch and digital passenger experiences — one platform, every workflow.

→ Product Identity · Platform Vision · Docs Hub

---

Start Here — Product Overview

For investors, partners, and operators evaluating Busflow. The pages below tell our story end-to-end — read top-to-bottom for roughly a 30-minute walkthrough.

#	Read	What you'll learn
1	Product Identity	Who Busflow serves, the five product pillars, and the value operators get from day one.
2	The 10% — AI & UX Differentiators	The features that set Busflow apart from incumbents and patchwork tools.
3	Competitive Landscape	How Busflow stacks up against Kuschick, Turista, and other DACH incumbents.
4	Core User Journeys	End-to-end scenarios showing how dispatchers, drivers, and passengers experience the system.
5	Platform Vision	The three-horizon roadmap from "Operator-in-a-Box" to a Ground Transportation OS.
6	Feature Subsets	How modular architecture enables wedge-and-expand commercial packaging.

---

Internal Developer Entry Point — Domain-specific rules and learnings live in .agents/skills/.

Quick Start

pnpm install
pnpm dev

This boots all primary projects via Turborepo. For workspace-only, landing page, or Hasura CLI commands, see the CLI Cheatsheet.

Prerequisites: Node.js (v20+), pnpm (v9+), Docker & Docker Compose.

Architecture & Tech Stack

• Core: Vue 3, Hasura (GraphQL), PostgreSQL, NestJS, Nhost, Docker on Hetzner.
• Tech Stack Reference — exhaustive breakdown of libraries and architectural decisions.
• CI/CD & Observability — deployment details and topologies.
• Product Identity — vision, design principles, and target market.

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

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

For comprehensive navigation, visit the Busflow Docs Hub.

Contributing & Rules

• Code Standards: Conventional Commits (feat:, fix:). Prefer self-documenting code and structural outputs (JSON, YAML).
• AI Agents: All domain-specific instructions, security rules, and workflows live 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.