These instructions are written for a Mac setup. All tools listed should be installable or have alternatives on Windows/Linux, but the steps might be different from those listed.

1. Ensure you have been invited and can access the following pages

   1. Figma
   2. Slack (Turn notifications on)
   3. Google Calendar (Turn notifications on)
   4. Notion (if you’re reading this, you do!)
   5. Github
   6. Heroku
   7. Tailwind
   8. The app

2. Install dependencies

   • Homebrew for Mac, Linux on Windows for Windows (requires restart)
   • Git
   • Deno
   • Postgres.app
   • Redis (Windows: install Redis using the **Ubuntu** terminal)
   • Heroku CLI
   • Docker
   • brew install gh

3. Install tools

   • Postgres Client: Postico for Mac, PgAdmin for Mac & Windows or DataGrip (macOS and Windows)
   • Slack for mobile and desktop with notifications on
   • Visual Studio Code
     • Live Share
     • Deno Extension
   • Chrome Extensions (optional)
     • html.to.design
     • EditThisCookie
     • Preact Developer Tools
     • HTTP Headers
   • Github CLI

4. Clone the repository.

   https://github.com/Virtual-Hospitals-Africa/virtual-hospitals-africa

   git clone [email protected]:Virtual-Hospitals-Africa/virtual-hospitals-africa.git --recursive
   

5. Run redis in another terminal window (if it’s not already running as a daemon)

   redis-server
   

6. Run ./setup.sh. If you missed any dependencies or are running Windows you may need to follow the steps manually to create the .env files correctly

   ./setup.sh
   

   Manual Local Setup

7. Run the project locally. You will see TLS errors. Those can safely be ignored for now

   deno task start
   

8. Access the application at https://localhost:8000. You should be prompted to log in via google.

   

9. If you could log in, you’re fully up! Try the workflows from Testing things out