diff --git a/.env.example b/.env.example index 4fc66b6..54a5c2c 100644 --- a/.env.example +++ b/.env.example @@ -1,5 +1,7 @@ # copy this file into the root directory as .env # replacing the API keys +# Example: +# REACT_APP_FIREBASE_API_KEY=AbCd1234 REACT_APP_FIREBASE_API_KEY= REACT_APP_GCAL_API_KEY= diff --git a/README.md b/README.md index 95d31ff..1e8a993 100755 --- a/README.md +++ b/README.md @@ -1,9 +1,43 @@ # USC Website +First time contributing to a project? Check out our [contributing guide](CONTRIBUTING.md)! + ## Development instructions -1. Install node and yarn -2. Clone the repo and run `yarn` -3. Copy the `env.example` file into `.env` at the root directory, -Including in the appropriate API keys. -4. run `yarn start` to start developing. +If you see code blocks as below, you are supposed to copy them line by line, and run it in a +terminal. To fire up a terminal, Ctrl + Alt + T usually does the job. + +1. Install NodeJS and Yarn, as per the [contributing guide](CONTRIBUTING.md). +1. Check that you have NodeJS 10 and Yarn running. You can use + +```bash +node --version +yarn --version +``` + +1. Clone the repo by and run `yarn`. + +```bash +git clone https://github.com/usdevs/usc-website.git +cd usc-website +yarn # installs all dependencies +``` + +1. Create a Firestore database for your own use, using this + [guide](https://firebase.google.com/docs/firestore/quickstart). + You can use test mode and choose a location of your liking, preferably + as close as possible to Singapore. +1. Find your Firestore API key using this + [guide](https://support.google.com/firebase/answer/7015592), + following the instructions for Web App. +1. Copy the `.env.example` file into `.env` at the root directory, + +```bash +cp .env.example .env +``` + +Including in the appropriate API keys by using your favourite editor. + +1. Run `yarn start` to start developing! You can now view the USC-Website that is run on your laptop + locally at `localhost:8000`. Note that any changes to the UI and data will NOT affect the real USC Website + so hack away!