Initial repository and Wagtail setup

.copier-answers.yml

@@ -7,11 +7,11 @@ default_branch: main
 dependabot_open_pull_requests_limit: 10
 dismiss_stale_reviews: false
 enable_dependabot_version_updates: true
-module_name: dis_wagtail
+module_name: cms
 package_manager: poetry
 repo_settings: custom
 repository_description: The Django Wagtail CMS for managing and publishing content
-    for the Office for National Statistics (ONS)
+  for the Office for National Statistics (ONS)
 repository_name: dis-wagtail
 repository_owner: ONSdigital
 repository_visibility: public

.design-system-version

@@ -0,0 +1 @@
+70.0.17

.docker/Procfile

@@ -0,0 +1,3 @@
+web: python manage.py runserver 0.0.0.0:8000
+scheduler: python manage.py scheduler
+frontend: npm run start:reload

.docker/bashrc.sh

@@ -0,0 +1,10 @@
+# Note: This file is loaded on all environments, even production.
+
+alias dj="django-admin"
+
+if [ -n "$DEVCONTAINER" ]
+then
+    alias djrun="django-admin runserver 0.0.0.0:8000"
+    alias djrunplus="python manage.py runserver_plus 0.0.0.0:8000"
+    alias honcho="honcho -f .docker/Procfile"
+fi

.dockerignore

@@ -0,0 +1,50 @@
+/Dockerfile
+/docker-compose.yml
+/docker-compose.override.yml.example
+
+.git
+**/__pycache__
+*.pyc
+.DS_Store
+*.swp
+/venv/
+/.venv/
+/static/
+/media/
+/tmp/
+/.vagrant/
+/Vagrantfile.local
+node_modules/
+coverage
+/npm-debug.log
+/.idea/
+/.devcontainer/
+/.mypy_cache/
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+/database_dumps
+
+/cms/static_compiled
+/cms/settings/local.py
+
+/cms/jinja2/assets/styles/print.css
+/cms/jinja2/components
+/cms/jinja2/layout

.eslintignore

@@ -0,0 +1,9 @@
+node_modules
+coverage
+/cms/jinja2
+/cms/static_compiled
+/static
+venv
+.mypy_cache
+.venv
+.coverage

.eslintrc.js

@@ -0,0 +1,5 @@
+module.exports = {
+  root: true,
+  // See https://github.com/wagtail/eslint-config-wagtail for rules.
+  extends: ['@wagtail/eslint-config-wagtail', 'plugin:@typescript-eslint/recommended'],
+};

.github/ISSUE_TEMPLATE.md

@@ -22,9 +22,9 @@ Describe what actually happened. Include details like error messages or unexpect
 
 Any relevant technical information. Include as much information as possible, including:
 
-- **Operating System**:
-- **Browser/Application Version**:
-- **Additional relevant software versions**:
+-   **Operating System**:
+-   **Browser/Application Version**:
+-   **Additional relevant software versions**:
 
 ### Proposed Solutions (Optional)
 

.github/dependabot.yml

@@ -16,12 +16,12 @@ updates:
       gh-security-updates:
         applies-to: security-updates
         patterns:
-          - "*"
+          - '*'
 
       gh-version-updates:
         applies-to: version-updates
         patterns:
-          - "*"
+          - '*'
 
   # Enable Security updates for Python package manager
   - package-ecosystem: pip
@@ -40,9 +40,9 @@ updates:
       py-security-updates:
         applies-to: security-updates
         patterns:
-          - "*"
+          - '*'
 
       py-version-updates:
         applies-to: version-updates
         patterns:
-          - "*"
+          - '*'

.github/release.yml

@@ -17,4 +17,4 @@ changelog:
         - Documentation
     - title: Other Changes
       labels:
-        - "*"
+        - '*'

.github/workflows/ci.yml

@@ -8,17 +8,16 @@ on: # yamllint disable-line rule:truthy
     branches: [main]
 
 concurrency:
-  group: "${{ github.head_ref || github.ref }}-${{ github.workflow }}"
+  group: '${{ github.head_ref || github.ref }}-${{ github.workflow }}'
   cancel-in-progress: true
 
 jobs:
-  lint-test:
-    name: Lint and Test
-    runs-on: ubuntu-22.04
+  lint:
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
       - name: Install Poetry
-        run: pipx install poetry==1.7.1
+        run: pipx install poetry==1.8.3 # keep in sync with pyproject.toml
 
       - name: Set up Python
         uses: actions/setup-python@v5
@@ -31,6 +30,105 @@ jobs:
 
       - name: Lint Python
         run: make lint
+      - name: Lint HTML
+        run: make lint-html
 
+  lint-front-end:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v3
+        with:
+          node-version-file: '.nvmrc'
+      - name: Install npm dependencies
+        run: npm ci --no-audit
+      - name: CSS linting
+        run: npm run lint:css
+      - name: JS linting
+        run: npm run lint:js
+      - name: Prettier
+        run: npm run format
+
+  compile_static:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+      - id: node-cache
+        uses: actions/cache@v4
+        with:
+          path: node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('**/.nvmrc') }}-${{ hashFiles('**/package-lock.json') }}
+      - if: steps.node-cache.outputs.cache-hit != 'true'
+        run: npm ci --no-audit
+      - run: npm run build:prod
+      - uses: actions/upload-artifact@v4
+        with:
+          name: static
+          path: cms/static_compiled/
+
+  test-python:
+    runs-on: ubuntu-latest
+    needs:
+      - lint
+      - lint-front-end
+      - compile_static
+
+    env:
+      DJANGO_SETTINGS_MODULE: cms.settings.test
+      DATABASE_URL: postgres://postgres:postgres@localhost/postgres # pragma: allowlist secret
+      ENABLE_DJANGO_DEFENDER: 'false'
+      POSTGRES_HOST_AUTH_METHOD: trust
+      SECRET_KEY: fake_secret_key_to_run_tests # pragma: allowlist secret
+
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres # pragma: allowlist secret
+          POSTGRES_DB: postgres
+        ports:
+          - 5432:5432
+        options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install Poetry
+        run: pipx install poetry==1.8.3 # keep in sync with pyproject.toml
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: .python-version
+          cache: poetry
+
+      - name: Install dependencies
+        run: make install-dev
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: static
+          path: cms/static_compiled/
+
+      - name: Fetch Design System templates
+        run: make load-design-system-templates
+      - name: collectstatic
+        run: poetry run ./manage.py collectstatic --verbosity 0 --noinput --clear
+      - name: System checks
+        run: poetry run ./manage.py check
+      - name: Check for missing migrations
+        run: poetry run ./manage.py makemigrations --check --noinput
+      - name: Create cache table
+        run: poetry run ./manage.py createcachetable
       - name: Test
         run: make test
+
+  docker:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build Docker Image
+        run: docker build --target release -t ons .

.github/workflows/codeql.yml

@@ -16,10 +16,10 @@ on: # yamllint disable-line rule:truthy
 
   schedule:
     # Run on a daily interval at 12pm UTC
-    - cron: "0 12 * * *"
+    - cron: '0 12 * * *'
 
 concurrency:
-  group: "${{ github.head_ref || github.ref }}-${{ github.workflow }}"
+  group: '${{ github.head_ref || github.ref }}-${{ github.workflow }}'
   cancel-in-progress: true
 
 jobs:

.github/workflows/mega-linter.yml → .github/workflows/mega-linter.yml_todo

@@ -41,7 +41,7 @@ env:
   REPORTERS_MARKDOWN_TYPE: simple
 
 concurrency:
-  group: "${{ github.head_ref || github.ref }}-${{ github.workflow }}"
+  group: '${{ github.head_ref || github.ref }}-${{ github.workflow }}'
   cancel-in-progress: true
 
 jobs:
@@ -134,8 +134,8 @@ jobs:
           !contains(github.event.head_commit.message, 'skip fix')
         with:
           token: ${{ secrets.PAT || secrets.GITHUB_TOKEN }}
-          commit-message: "[MegaLinter] Apply linters automatic fixes"
-          title: "[MegaLinter] Apply linters automatic fixes"
+          commit-message: '[MegaLinter] Apply linters automatic fixes'
+          title: '[MegaLinter] Apply linters automatic fixes'
           labels: bot
 
       - name: Create PR output
@@ -195,4 +195,4 @@ jobs:
               github.head_ref ||
               github.ref
             }}
-          commit_message: "[MegaLinter] Apply linters fixes"
+          commit_message: '[MegaLinter] Apply linters fixes'

.gitignore

@@ -169,3 +169,21 @@ copier_scripts/
 
 # DS_Store files
 .DS_Store
+
+#
+# Project-specific
+#
+
+# DS
+/cms/settings/local.py
+
+/cms/jinja2/assets/styles/print.css
+/cms/jinja2/components
+/cms/jinja2/layout
+/cms/static_compiled
+
+node_modules/
+static/
+
+# mkdocs
+/site

.mega-linter.yml

@@ -37,4 +37,4 @@ FILEIO_REPORTER: false
 # Use yml file to allow the use of comments. Megalinter's default is .markdown-lint.json
 MARKDOWN_MARKDOWNLINT_CONFIG_FILE: .markdown-lint.yml
 
-YAML_V8R_FILTER_REGEX_EXCLUDE: "dependabot.yml" # Dependabot yaml in SchemaStore is currently not up to date. Dependabot is validated on push by GitHub by default.
+YAML_V8R_FILTER_REGEX_EXCLUDE: 'dependabot.yml' # Dependabot yaml in SchemaStore is currently not up to date. Dependabot is validated on push by GitHub by default.

.nvmrc

@@ -0,0 +1 @@
+20