Run ReacherX on your own computer

Follow the guide for the part of the app you want to work on. Missing settings can stop that part from working, even if the rest of the app starts.

Some values belong in .env.local; others belong in your Convex deployment settings. The guide lists the right place for each. Don't commit your local settings or keys to Git.

Start the app

Set up the backend once:

Then leave this running in one terminal:

In a second terminal, start the website:

Open the localhost address printed in the terminal, usually http://localhost:3000.

Make one useful change

A confusing error message or a setup step that didn't work is a good first contribution. You don't have to begin with a large feature.

Read the contribution guide, look for an existing component or helper you can reuse, and test the behavior you change. For bigger ideas, talk to me before you start so we can agree on what to build.

If you want to work on the AI side, the agent walkthrough points to the main files. And if you're wondering why the whole application is open, here's the story behind that decision.