https://decibels-website.herokuapp.com/vast
Install prerequisites:
- Git - https://git-scm.com/download
- Yarn - https://yarnpkg.com/en/
- Node.js - https://nodejs.org/en/
- VS Code - https://code.visualstudio.com/ (Only needed if editing the source)
To Run:
- Clone the repository:
git@github.com:180decibels/website.git
- Start VSCode, click File->Open Folder, and select the
website
folder from the cloned git Repo in the previous step - From the shell in VSCode (or any shell, opened to the
Website
folder)- Install dependencies -
yarn
- Build a client distribution -
yarn run build
- Create a local empty database -
yarn run db:create
- Start the development server & client webpack server -
yarn run dev
(Opens a browser window automatically)
- Install dependencies -
If you want to see into the locally running database, install sqlLiteBrowser (https://sqlitebrowser.org/
) and open website/server/dev.sqlite3
This file is not committed to the git repo, but generated via the steps above
Use VSCode as an editor
Use Chrome as a browser, with the following extensions:
- Redux DevTools
- React DevTools
- Apollo Client Developer Tools
Depending on how you want to run it, use these steps:
- Run Both the client and server in development mode
yarn
yarn run dev
- Run only the client in development mode
cd client
yarn run dev
Using the Debugger:
To Debug the server: (Set breakpoints in files under src/server
in VS Code)
- Start the
Debug Server
debug configuration via VS Code - Run only the client as-per instructions above
To Debug the client: (Set breakpoints in files under src/client
in VS Code)
- Start Both the client and server in development mode, as per instructions above.
- Start the
Launch Chrome
debug configuration via VS Code, and interact via the chrome instance launched by VS Code
Create-React-App 2.0 based website, using redux, redux-saga, and modular sass. Apollo GraphQL client for API requests
Express based server, with Apollo GraphQL server under /graphql