Skip to content

Default Compas template

This project is created using the default template.

Maintenance mode

Compas is in maintenance mode. The packages will be maintained for the foreseeable future. New features might be added, but some will also be dropped in favor of other ecosystem-available libraries. Please don't start new projects using Compas.

Getting started

  • Start up the development Postgres and Minio instances
    • compas docker up
  • Apply the Postgres migrations
    • compas migrate
  • Regenerate router, validators, types, sql, etc.
    • compas generate / compas generate application
  • Run the tests
    • compas test --serial

Structure and features

This project is structured according to the default Compas template.

  • Uses @compas/eslint-plugin with compas lint for running ESLint and Prettier
  • Has code generation based on @compas/code-gen, with the definitions stored in gen/* and a custom command in commands/generate.js
  • Contains 'global' services via ES Module live bindings in services/core.js.
  • Entrypoint for both starting the api via compas run api / node ./scripts/api.js and a background queue via compas run queue / node ./scripts/queue.js.
  • Tests running on a temporary Postgres database, temporary S3 bucket and validating responses.