- React - UI framework/library
- TypeScript - strict types for JavaScript
- Firebase - authentication functionality (Firebase Auth), database (Firestore), web app hosting (Firebase Hosting). Basically, it serves as the backend for our app.
- Chakra UI - UI component library
- Vite - thing that bundles all the above together. A tool that takes all the source code files and bundles them together to build the app 🛠️
This bulleted list will help you set up your machine for local development.
- All following commands use a shell terminal (bash, zsh, whatever). On MacOS and Linux, it is available for you out of the box. On Windows, you have to either install WSL (which is time consuming), or Git Bash. This answer contains some useful links: https://superuser.com/a/1763710
- Create a GitHub account (if haven't yet). Don't forget to pick a cool username 😎
- Install Git (if haven't yet or not available): https://github.com/git-guides/install-git
- Install Node.js 20: follow instructions on https://nodejs.org/en/download/package-manager
- Install VSCode or your preferred text editor / IDE: https://code.visualstudio.com/Download
- Configure your editor to run ESLint on file save. This will ensure the code looks great for everyone the same way 💅
- if using VSCode, paste the following snippet into .vscode/settings.json file (create if missing):
{"typescript.tsdk": "node_modules/typescript/lib","editor.codeActionsOnSave": {"source.fixAll.eslint": "explicit"},"[json]": {"editor.defaultFormatter": "vscode.json-language-features","editor.formatOnSave": true}}
- if using any other IDE, start questioning your life decisions. Or just ask mentors for help 😇
- if using VSCode, paste the following snippet into .vscode/settings.json file (create if missing):
- Clone this Git repository:
- create a dedicated folder for cool projects like this one (or use your preferred one):
cd ~; mkdir Projects; cd Projects
. - copy the Git repository URL: on the GitHub page of this repository, click the green
<> Code
button >📋
button to the right of the repository url. - in the cool projects folder, execute the
git clone <copied repository url>
command, pasting the repo url. This will copy the project files from GitHub to your machine. - navigate to the cloned repository by
cd <repository name>
.
- create a dedicated folder for cool projects like this one (or use your preferred one):
- Install JavaScript dependencies using NPM:
npm install
- Start the app dev server with
npm run dev
- Go to http://localhost:5173/ to see this wonderful project live
- Make changes to files within the src/ folder to see them reflected on the page
- You should be all set! Now you can start contributing to the project! 🤘