Note
Sponsored by the Open Source project Flagsmith https://github.com/Flagsmith/flagsmith
How friendly is your GitHub Open Source Repo? This project will check to make sure you are using Best Practices to attract more users, contributors and Stars, as well as suggest steps as to how you can improve the Repo to achieve this.
- GitHub OAuth
- Integration with Flagsmith
- Add GitHub repo URL
- List of checks and show detailed report
- Badges to show latest status in project's README
- ...
- Login with your GitHub (only public info required)
- Add GitHub repo URL
- Run HealthCheck against repo and view the report
- Add a HealthCheck badge to your project
Caution
Node v21+
is required
-
Clone this GitHub Repo
-
Install the dependencies with
npm ci
-
Copy
.env.example
to.env
(you will need an environment key from Flagsmith, this is shown later on) -
Create a free account on Flagsmith https://www.flagsmith.com (you can also sign in with GitHub)
-
Create an Organisation and Project
-
Create the Feature Flags with these steps
a. Create the feature
tagline
by clickingCreate Feature
b. Fill in the Feature Flag form with these details and click
Create Feature
c. (OPTIONAL) Import the flags to your Flagsmith account using the file
src/config/flagsmith.json
(note this will be per environment, for exampledevelopment
) -
Get your environment key from Flagsmith and add to
.env
file
-
To be able to log in using GitHub OAuth
a. create a GitHub OAuth app on GitHub https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app
b. In your GitHub OAuth app, GitHub will generate the
client id
andclient secret
, add these to your the.env
file -
Run the project with one of these
a. Locally
npm run dev
b. Docker compose
docker compose -f docker-compose.local.yaml up -d