@busflow/booking-widget

Status: Scaffold — not yet implemented

Purpose

Embeddable B2C checkout widget. Standalone SPA or <script> embed on operator websites. Focused on conversion — discovery, seat selection, payment. After checkout, passengers are redirected to the passenger portal.

Tech Stack

• Framework: Nuxt 3 (SPA mode)
• Design: @busflow/ui-core with .theme-passenger (warm, boutique hotel aesthetic)
• Payments: Apple Pay, Google Pay, PayPal, SEPA, Klarna

Key Features (planned)

• Tour discovery & SEO landing pages
• Zustiegsstellen-Manager (boarding point selection)
• Chassis-linked interactive seat selection (10-min reservation lock)
• Frictionless guest checkout (no forced account creation)
• Ancillary marketplace (insurance, excursions, upgrades)
• Localized deposit logic (deposit / final payment)
• B2B White-Label API portal for travel agencies

Architecture

Follows Feature-Sliced Design.

Public API / Entrypoints

• Planned app entrypoint: Nuxt SPA build and embeddable checkout surface.
• External integration contract should stay stable for operator websites.

Key Commands

• No package-specific commands yet; use the eventual app filter once package.json exists.

Related Docs

• App Structure
• Product User Journeys
• Booking Lifecycle Protocol
• Commerce Schema

Common Pitfalls

• Keep conversion-critical checkout flows independent from backoffice assumptions.
• Do not require passenger accounts for guest checkout.