This repository hosts a complete demo of how clients may integrate with Entur's implementation of the Open Mobility Sales API (OMSA). Each client lives under clients/, each backend-for-frontend (BFF) under bffs/. Shared documentation and guides for BFF + client combinations live under docs/.

Note from October 15 2025: We currently only support a Flutter client + Python FastAPI BFF. This repo may contain other clients and BFFs in the future.

Note from October 21 2025: This project is a Work-in-Progress and is not in a state we deem "demo ready" yet. The Flutter client has been partially developed with Copilot, and there may therefore be code that is not necessarily up-to-date with current Flutter industry standards. We are currently working on verifying and improving the app in order to provide a more complete demo that can accurately demonstrate the kinds of interactions and user experiences that can be created when integrating with our OMSA API.

clients/
  flutter/             Cross-platform mobile client
bffs/
  python-fastapi/      Reference FastAPI BFF
docs/                  Shared documentation and BFF + client integration guides

• Each project documents its own setup:
  • clients/flutter/README.md covers the Flutter demo app.
  • bffs/python-fastapi/README.md covers the FastAPI BFF.
• Integration guides live in docs/. Start with docs/flutter-fastapi-guide.md to run the Flutter client against the FastAPI BFF.

• Add new client/BFF pairings under docs/ as client-bff-guide.md to keep combinations discoverable (e.g. react-express-guide.md).
• Official OMSA specification: https://github.com/OMSA-Open-Mobility-Sales-API/OMSA

Please open an issue if you encounter bugs or have feature requests.