django-girder-style 0.1.0

Styled Django templates for data management applications.

django-girder-style

Styled Django templates for data management applications.

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 from the tailwind/ directory, but be sure to re-build Docker afterwards (via Application Maintenance above).