Skip to content

LukasWestholt/betterbahn

 
 

Repository files navigation

BetterBahn

BetterBahn is a web app for finding the best train journeys in Germany. While split ticketing is supported to help save money, it is rather the exception. The app will be extended with many more features in the future.

Technology

This project uses the db-vendo-client for accessing Deutsche Bahn ticketing data, which is licensed under the ISC License.

Legal Notice

This is not an official repository or project of Deutsche Bahn AG. It is an independent project and not affiliated with or endorsed by Deutsche Bahn. To use this code or the db-vendo-client permission from the Deutsche Bahn AG is necessary.

Getting Started

To run the project locally:

  1. Clone the repository and navigate to the folder

  2. Install dependencies with pnpm install

    You can install pnpm via corepack (included with Node.js):

    corepack enable
    corepack prepare pnpm@latest --activate
    
  3. Start the development server with pnpm run dev

Docker

You can also build and run BetterBahn as a Docker container. A Dockerfile is included in the repository.

Docker Compose

You can run the app with docker compose:

Default/Development

docker compose -f docker-compose/docker-compose.yaml --project-directory=./ up -d

http://localhost:3000

License

This project is licensed under the AGPL-3.0-only. See the LICENSE file for details.

Community and Contribution

Join the Discord community to ask questions, share feedback, and connect with other users and contributors.

Want to contribute? Please read the Code of Conduct and see the Contributing Guide for details on how to get started.

How it works

BetterBahn searches for train journeys and can use split ticketing to help you find cheaper options—though this is usually the exception, not the rule. For a detailed explanation and demonstration, check out the YouTube video.

About the Author

Created by Lukas Weihrauch.

If you like what I do, consider supporting me: ko-fi.com/lukasweihrauch


Made with ❤️ for train travelers in Germany.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 97.8%
  • Dockerfile 1.1%
  • Other 1.1%