Open Sauced provides structured onboarding for new contributors to open source. This structure provides a way to track your next contributions by leveraging a unique dashboard built on top of the GitHub GraphQL API.
We encourage you to contribute to Open Sauced! Please check out the Contributing guide for guidelines about how to proceed.
In order to run the project from a container we need node>=14
, npm>=7
and docker>=20
installed on our development machines.
npm install
npm start
For running the test suite, use the following command. Since the tests run in watch mode by default, some users may encounter errors about too many files being open. In this case, it may be beneficial to install watchman.
# the tests will run in watch mode by default
npm test
# to clean snapshots
npm run clean
Storybook is being leveraged to mock out visual React components. The latest version of the design system can be found at this URL.
npm run storybook
Authentication is handled through OneGraph's AuthGuardian service.
This project uses GitHub as a database. When you login, you will be presented with a button to create a goals repository. That repository template lives at open-sauced/goals-template.
This project uses the sw-precache to kickstart an offline cache. The offline cache only registers in production. If service needs to be manually removed make an unregister call from the registerServiceWorker.js import.
This project supports "dark mode" styling, and by default it will follow the color preference on your device. It also allows for overriding this using buttons at the top right of the screen, which will persist the preference to local storage on your device. More info about color preference web API's can be found here: MDN Web Docs
This project leverages Remirror for a delightful experience in documenting your Open Source goals. The editor supports markdown features including heading levels, bulleted lists, text formatting, code snippets, and emojis!
Got Questions? Join the conversation in our Discord.
Find Open Sauced videos and release overviews on our YouTube Channel.
Visualization of this repository
MIT Β© Open Sauced