Quick Start

This section is meant to get you set up with building your dictionary as quick as possible.

1. Create a starter project: mothertongues new-project

   • you will be asked to provide a file location
   • the project created will contain sample data that can be immediately used to see the dicitionary in action

2. Build and run your dictionary: mothertongues build-and-run "<FileLocationYouProvided>/config.mtd.json".

   • Your dictionary will be available on your computer at http://localhost:3636
   • Press ctrl+c to exit the server from your terminal.

   Local-development-note

   If you are customizing MTD code, and you want to see your changes deployed locally, you need to run the above commands within the uv environment that was automatically setup for you upon local installation.

   This can be done by prefixing all mothertongues commands with uv run (e.g. uv run mothertongues new-project) or by activating the environment directly (source .venv/bin/activate).

   Check out the uv documentation for more details