Skip to content

Latest commit

 

History

History
31 lines (25 loc) · 1.26 KB

DEVELOPMENT.md

File metadata and controls

31 lines (25 loc) · 1.26 KB

Develop with Docker

Initial Setup

  1. Run docker-compose run --rm django ./manage.py migrate
  2. Run docker-compose run --rm django ./manage.py createsuperuser and follow the prompts to create your own user

Run Application

  1. Run docker-compose up
  2. Access the site, starting at http://localhost:8000/
    • Outgoing emails are sent to the console
  3. The Django admin interface is still available at http://localhost:8000/admin/
  4. When finished, use Ctrl+C

Testing

  1. Run docker-compose run --rm django tox
  2. Run docker-compose run --rm tailwind yarn lint --fix

Application Maintenance

Occasionally, new package dependencies or schema changes will necessitate maintenance. To non-destructively update your development stack at any time:

  1. Run docker-compose build --pull --no-cache
  2. Run docker-compose run --rm django ./manage.py migrate

Install Javascript packages

In the event that Javascript packages need to be installed, this can be done via Docker Compose:

  1. Run: docker-compose run --rm tailwind yarn add -D package-name, substituting package-name as appropriate.

This can also be done natively by running Yarn commands in the repository root, but be sure to re-build Docker afterwards (via Application Maintenance above).