Welcome to the getting started page! Here is all you need to know to get this repo up and running on your local machine, as well as good collaborative coding practices
- Clone this repository
git clone <repo-url>
- Run
npm i
at the root of the repository - TODO: Setup backend
- Install IDE Extensions
- Enable format on save in your IDE
- Enable the pre-commit hook by running
npx mrm@2 lint-staged
at the root of your repository - Familiarize yourself with Helpful Commands, the Project Structure, the steps for contributing, and the repository features.
- Review the repo-features document to understand what is included in this repository off the bat
- Set up the backend for your team
- Edit the "One time setup" section above as needed, then execute those steps
- Turn on branch protections
- Visit your repo on github.com
- Click the Settings button on the top bar
- Click the branches tab on the left sidebar
- Click add rule
- Click "Require a pull request before merging"
- Create
npm start
: Boot up your frontendnpm run lint-check
: make sure Prettier and ESLint passnpm run lint-fix
: make sure Prettier and ESLint pass and try to automatically fix all issues (some ESLint issues must be resolved manually)git stash
: Temporarily remove all local changes to a branch and save them. Good when you need to hop to another branch without committing your current code.git stash apply
: Reapply most recent git stash.git merge orgin/main
: Pull all changes from the main branch to yours, good for resolving merge conflicts.
- .github Github Actions CI/CD and Issue/PR templates
- .husky Linting pre-commit hook Read More
- docs Documentation - images Images used for documentation - template-repo Documentation that came with the template repository
- public Assets for frontend Read More
- src Frontend code - tests Tests for the frontend - components React components - App.tsx Top level React component, where most routing goes - App.css Top level CSS, where all global CSS rules go