/sensoria

School project to create a sensor monitoring dashboard.

Primary LanguageTypeScript

Sensoria

Setup

Prerequisites

Note: To install pnpm globally, you can run:

npm install -g pnpm

Install dependencies

You just need to install the dependencies with pnpm:

pnpm install

VSCode setup

You can install the recommended extensions for this project:

  1. Open the command palette with Ctrl+Shift+P (or Cmd+Shift+P on macOS).
  2. Type Extensions: Show Recommended Extensions.
  3. Click on the Install Workspace Recommended Extensions button (the one with the down arrow in a cloud).

Development

pnpm dev

By default, the GraphQL server will be running on port 4000 and the React app on port 3000. You can change the ports by creating a .env file with the following content:

API_PORT=2023
CLIENT_PORT=2024

To access database, you need to run the following command:

cd apps/api
docker-compose up -d
pnpm migration:run

You can copy the .env.example file located in apps/api and rename it to .env to define the database credentials.

Applications and Packages overview

Name Description Location
api GraphQL server apps/api
client React app apps/client

Contributing guidelines

  • Do create an issue from a project card with the GitHub button Convert to issue.
  • Don't commit directly to main branch.
  • Do create the new branch with the GitHub button Create a new branch for this issue.
  • Do follow the Contributing guidelines section of the application or package you are working on.
  • Do write commit messages following Conventional Commits guidelines.