open-sauced / hot

πŸ•The site that recommends the hottest projects on GitHub.
https://hot.opensauced.pizza
MIT License
418 stars 143 forks source link

Feature: Document necessary pathway to correctly set up local dev environment. #480

Open JDGuillaume opened 1 year ago

JDGuillaume commented 1 year ago

Type of feature

πŸ• Feature

Current behavior

  1. Currently, there's not a lot of documentation around the correct way to set up a fully-functional local dev environment to work on the hot repo.
  2. Documentation does not clearly indicate which environmental variables should be used and which API a local dev environment should utilize (i.e., beta vs. current).
  3. Documentation does not clearly indicate or explain how to set up a personal Supabase account https://github.com/open-sauced/api#-setting-up-your-supabase-instance.
  4. Documentation does not clearly indicate or explain how to setup OAuth with GitHub.
  5. Documentation does not currently explain or utilize Open Sauced's walkthrough of how to retrieve one's authentication token to enable API authorization locally Open Sauced Docs.

Suggested solution

This issue is primarily an extension of https://github.com/open-sauced/api/issues/226, more focused on the hot repo.

After discussing with @jpmcb and @bdougie in the Open Sauced Discord, I was able to make a lot of headway toward spinning up a local dev environment, including:

However, there's no current documentation or direction around populating the Supabase database with either the correct schema or seeding it with relevant data.

I would love the opportunity to tackle this documentation personally. However, I would like more guidance on the last mile work (i.e., populating the database). Currently, this is blocking progress on https://github.com/open-sauced/hot/issues/416, as I'm not able to replicate the fully authenticated state and successfully fetch data from the database.

Additional context

No response

Code of Conduct

Contributing Docs