Murty Website

Summary

This repository contains the murty.au website, which has been built with Deno, Lume, a licensed version of the IO font by Mass-Driver, and the free Font Awesome icon pack.

Tests, build and local server commands are available from local environments.

Remote testing and GitHub Pages deployment can be triggered locally and is then handled remotely by a GitHub Actions workflow.

Folder Structure

Path	Description
.github/actions	Helper actions for GitHub Actions workflows
.github/workflows/release.yml	Triggers when a release tag is pushed. Runs tests, deploys to GitHub Pages and publishes a new GitHub release.
.vscode	Customised VS Code configuration for this repository.
assets	Static files like images and PDFs.
config	Supporting configuration files.
content	Website page content in Markdown files.
dev	Dev helper scripts, run deno task to show available options.
docker	Docker configuration and documentation. See docker/README.md for details.
infra	Deployment infrastructure. See infra/README.md for details.
src	Source code and related unit tests.
src/layouts	Nunjucks page layouts.
src/styles	CSS styles.
src/templates	Nunjucks page templates.
AGENTS.md	AI Agent instructions, technical docs and guidance.
deno.json	Deno imports, tasks and configuration for this repository.

Initial setup

1. Fork this repository
2. Make a local clone of that forked repository
3. Install the latest stable release of Deno
4. Run the setup script: deno task setup
5. Update some files in the forked repository

• Update .github/workflows/release.yml to use your forked GitHub repository URL
• All files in the content directory must contain your own content instead
• All files in the assets directory must contain your own static files instead
• Purchase your own license to use the Mass-Driver IO font or update the CSS to use other fonts

6. Commit and push all of these changes to your forked repository
7. Update the Settings for your forked repository via GitHub:

• Pages > Source: GitHub Actions
• Pages > Custom domain: use your own domain

8. Update CNAME to use the same domain as you configured above
9. Setup Google Analytics:

• Create a new site in your own account
• Update your .env file's GOOGLE_ANALYTICS_SITE_CODE value to use your new Measurement ID

10. Optional: Install VS Code and add the Deno plugin

Docker Usage

For detailed Docker build and deployment instructions, see docker/README.md.