OMSA Example Clients

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/.

Repository layout

clients/
  flutter/             Cross-platform mobile client
  react-native/        Wayfare reisefrihet rider prototype
bffs/
  python-fastapi/      Reference FastAPI BFF
  reisefrihet-fastify/ Fastify BFF for the React Native prototype
docs/                  Shared documentation and BFF + client integration guides

Getting started

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

Documentation

• 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
• Node dependency security baseline: docs/node-dependency-security.md

Having problems?

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