nandedamana/flathub-website

Monorepo with website and API

flathub.org

This is the source code for the website, both backend and frontend. That's running on https://flathub.org.

Code contribution

First of all thanks for considering contributing to this project!

Pull requests are welcome. Please, create an issue first explaining what you want to do and how.

If you want to contribute translations, please check out the instructions below.

Development

You'll need git, yarn, docker and docker-compose-plugin.

Go to the folder where you manage your projects and checkout this project.

Then start the backend:

cd backend
docker compose up

You might need to use --build to rebuild the images, when dependencies change.

Use another terminal session to run the following or use your browser to go to https://localhost:8000/docs and use the UI to run the /update endpoint. This will populate the database with the latest data from Flathub.

curl -X POST localhost:8000/update

Then open a terminal and go to the frontend folder. If it's the first time you run it, run

yarn

Then you should be able to start the dev server and see changes to the code:

yarn dev

Generating api client

We're generating the api client from the openapi spec. To do so, make sure the backend is running and then run:

yarn openapi-codegen

Storybook

You can also start the storybook via:

yarn storybook

More backend instructions

You can find more backend instructions in the README in the backend folder.

Translations

We're using Weblate to translate the UI. So feel free, to contribute translations over there.

Stripe payment testing

In both staging and development environments, Stripe is running in test mode (all data is fake). To test payment, card details can be used from https://stripe.com/docs/testing.