Skip to content

zak1999/birdi

Repository files navigation

Birdi - Developer Guide

Birdi is a bird sighting application that allows bird enthusiasts and ornithologists to record and track their bird sightings. This guide provides detailed instructions for developers who want to set up and run Birdi locally.

Prerequisites Before getting started, you should have the following tools installed on your system:

  • Git
  • Node.js and npm
  • TypeScript
  • nodemon

Setting up the repository

  1. Open your terminal and navigate to the directory where you want to store the Birdi repository.
  2. Clone the repository:
     git clone <repo url>
  3. Navigate to the root directory of the cloned repository:
     cd birdi/

Installing dependencies

  1. Install dependencies in client folder:
     cd client/
     npm i
  2. Install dependencies in server folder:
     cd ../server/
     npm i

Compiling Typescript

  1. From server folder:

     tsc build

    dist folder will appear in server folder

  2. From client folder:

     tsc build

    dist folder will appear in the client folder

Running the client and server

  1. From the server folder:
     npm run dev
    Verify that 'Server listening on port PORT' and 'db connected' prints to the console.
  2. From the client folder:
     npm run dev
    The react app will open the default port.

Contributing

We welcome contributions to Birdi from the community. If you are interested in contributing, please read our contribution guidelines and reach out to us at alexryanjones@gmx.com, contact.sethjplatt@gmail.com or zakariyya_ahmed@outlook.com.

Support

For support with setting up and running Birdi locally, please contact us at alexryanjones@gmx.com, contact.sethjplatt@gmail.com or zakariyya_ahmed@outlook.com.

Screenshots