Skip to content

stack-on-fire/fire-flags

Repository files navigation

fireflags-banner

Suggest new features here

Join the discussion on Github

Dead simple and blazing fast feature-flags platform. Get started in minutes. Be confident when releasing new features for your application - you are one kill switch away from disabling the feature if it breaks. Just turn it off now and fix it later 👌

App example

fire-flags-demo.mp4

Get started with managed version

  • Visit flags.stackonfire.dev and sign in with any convenient method.
  • Create a new project
  • Create a new flag, rename it and add description if needed
  • Copy the link from the project page and make a request to that url to retrieve your feature flags

Here is a simple implementation of how you might user the feature.

Use with React

Official fire-flags library for react - engineered by Alfredo Salzillo

Get started with self-hosted version

Fire flags is dead simple to self host! You need to have an instance of Postgres database running, as long as you have the connection string you can safely deploy to Vercel. Environments variables necessary to run the app are listed in .example.env

Fire-flags currently offers three methods of authentication - magic link, github and twitter. The auth setup is powered by Next-auth and to make it work you need to provide correct environment variables to the project.

Contributions for dockerised version are highly welcome

Contribute

  • Clone the repo
  • run docker-compose up -d in the terminal to boot up the database
  • development environment uses MSW to mock session, so you don't need to set up next-auth related env variables to be able to log in. If you need to mimic login workflow - disable service workers in _app.tsx
  • run yarn run dev

About

Dead simple and blazing fast feature-flags platform. Get started in minutes. Be confident when releasing new features for your application!

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published