Usage

To create a new repository using this template:

1. Create a basic devcontainer either using the Codespaces default or using the file .devcontainer/devcontainer-to-instantiate-template.json from the base template repo
2. Inside that devcontainer, run python .devcontainer/install-ci-tooling.py to install necessary tooling to instantiate the template (you can copy/paste the script from this
3. Delete all files currently in the repository. Optional...but makes it easiest to avoid git conflicts.
4. Run copier to instantiate the template: copier copy --trust gh:LabAutomationAndScreening/copier-nuxt-python-intranet-app.git .
5. Run python .devcontainer/manual-setup-deps.py --optionally-check-lock to generate the lock file(s)
6. Stage all files to prepare for commit (git add .)
7. Run python3 .github/workflows/hash_git_files.py . --for-devcontainer-config-update to update the hash for your devcontainer file
8. Commit the changes (optional)
9. Rebuild your new devcontainer

Development

Obtaining the GraphiQL files to bundle

1. Navigate into the static folder: cd "template/{% if has_backend %}backend{% endif %}/src/static/{% if frontend_uses_graphql %}static{% endif %}/graphiql"
2. Confirm by viewing the source of a non-altered GraphiQL page that these are the files to download
3. curl https://unpkg.com/[email protected]/umd/react.production.min.js > react.production.min.js
4. curl https://unpkg.com/[email protected]/umd/react-dom.production.min.js > react-dom.production.min.js
5. curl https://unpkg.com/[email protected]/dist/js.cookie.min.js > js.cookie.min.js
6. curl https://unpkg.com/[email protected]/graphiql.min.css > graphiql.min.css
7. curl https://unpkg.com/@graphiql/[email protected]/dist/style.css > style.css
8. curl https://unpkg.com/[email protected]/graphiql.min.js > graphiql.min.js
9. curl https://unpkg.com/@graphiql/[email protected]/dist/index.umd.js > index.umd.js

Updating from the template

This repository uses a copier template. To pull in the latest updates from the template, use the command: copier update --trust --conflict rej --defaults