Desk Compass

"Where's my desk?" - Search no more: Manage your floor plan and space layout; Keep track of item locations; Collaborate to maximize overview for your office, event location or lecture rooms. Written with NestJS, Svelte and Leaflet.

#floor-plan #hacktoberfest #leaflet #nestjs-backend #svelte #desk #location #office

Demo Download

"Where's my desk?" - Search no more: Manage your floor plan and space layout; Keep track of item locations; Collaborate to maximize overview for your office, event location or lecture rooms.

About Desk Compass

Example screenshot:

Features

Display different types of markers, like people, tables, first aid kits a.s.o
Filter markers via search filter
Toggle visibility of markers and their labels by type
Move and rotate markers
Edit marker properties and upload an image
health and metrics endpoints available

Getting started

Build for development

You'll need Node.js >= 18.x and Yarn:

Run yarn install to install all necessary dependencies
Start server and frontend simultaneously with yarn start
See application UI http://localhost:3000/
See API at http://localhost:3030/api/swagger and as OpenAPI JSON at http://localhost:3030/api/swagger-json
See health indicator at http://localhost:3030/health
See application metrics at http://localhost:3033/metrics

Build for production

Create a production environment cp environments/.env.development environments/.env and adjust it accordingly
Run yarn install --frozen-lockfile --ingnore-scripts
Run yarn build
You'll need to copy a few files to your <TARGET_DIRECTORY
- mkdir <TARGET_DIRECTORY>/static
- cp -r node_modules/ <TARGET_DIRECTORY>/
- cp -r workspaces/api/dist/* <TARGET_DIRECTORY>/
- cp -r workspaces/api/frontend/* <TARGET_DIRECTORY>/static/
Then in your target directory node main

With Docker

$ docker build -t desk-compass .
$ MSYS_NO_PATHCONV=1 docker run --rm --name=desk-compass \
  -e DATABASE_PATH=/storage/db \
  -e IMAGE_STORAGE_PATH=/storage/images \
  -v "/.tmp/deskcompass:/storage:rw" \
  -p 5000:3030 desk-compass

Open http://localhost:5000/ in your browser

Environment variables:

The following environment variables are required to start the application:

IMAGE_STORAGE_PATH (must): Path to folder to store uploaded images. Read and write permissions for the application are required.
DATABASE_PATH (must): Path to folder to persist application data. Read and write permissions for the application are required.

The following environment variables are optional:

NODE_ENV: Should be set to development for local development. It is empty by default. If set to development, it will
- structure and colorize JSON log output
- enable Swagger UI for API endpoints (at http://localhost:3030/swagger)
API_PORT: adjust port to backend API, fallback is 3030
DATABASE_HUMAN_READABLE: application data is stored in a JSON file. Set this to true for readability.
CORS_ALLOWED_ORIGINS: comma-separated list of allowed origins (will be parsed as Regex). If not set, CORS will be disabled. Eg.: CORS_ALLOWED_ORIGINS="localhost:3000$,127.0.0.1:3000$".
CORS_ALLOWED_METHODS: comma-separated list of allowed methods. If not set, it will fall back to "GET,HEAD,OPTIONS,PUT,POST,DELETE"
METRICS_PORT: Port for metrics endpoint, defaults to 3033. This would expose http://localhost:3033/metrics for local development.

Developer guide

Install all necessary dependencies, create basic environment setup for local development and then start application in watch mode:

yarn install
cp workspaces/api/local.env workspaces/api/.env
yarn start

See application UI http://localhost:3000/
See API at http://localhost:3030/swagger and as OpenAPI JSON at http://localhost:3030/swagger-json
See health indicator at http://localhost:3030/health
See application metrics at http://localhost:3033/metrics

Run unit tests

Run frontend and API tests

yarn run test

Run API tests only

yarn workspace api run test

Run frontend tests only

yarn workspace frontend run test

For all calls a yarn run test:watch variant exists.

Run e2e tests

Install browsers with npx playwright install

Run e2e tests:

yarn run e2e

Run e2e tests in watch mode, which opens vitest UI:

yarn run e2e:watch

To run application and e2e tests independently, start the application first with

yarn start

and then in another console:

yarn workspace e2e run test:watch

Run linters

Run frontend and API linters

yarn run lint

Contributing

Contributing Guidelines

Read through our contributing guidelines to learn about our submission process, coding rules, and more.

Want to Help?

Want to report a bug, contribute some code, or improve the documentation? Excellent! Read up on our guidelines for contributing and then check out one of the project issues labeled as help wanted or good first issue.

License

This project is licensed under the MIT License - see the LICENSE file for details

Top categories

tailwind daisyui admin template popup mdsvex portfolio blog form ecommerce ui carousel auth dark seo image routing