chore: initialise Napper website repository

2026-07-27 08:56:30 +10:00
commit 20d2c2ab18
3 changed files with 102 additions and 0 deletions
@@ -0,0 +1,50 @@
+# AGENTS.md
+
+## Project purpose
+
+This repository contains the public website for the Napper application ecosystem.
+
+The site includes:
+
+- the main `napper.au` landing site;
+- the Hudra product site;
+- the Lildra product site;
+- the Pendra product site;
+- shared legal, privacy, support and ecosystem content.
+
+## Source of truth
+
+The repository is the source of truth, not individual conversations or AI sessions.
+
+When an important architectural, deployment, naming or development decision is made:
+
+1. update the appropriate repository documentation;
+2. update this file when the guidance affects AI contributors;
+3. avoid relying on undocumented conversational context.
+
+## Working principles
+
+- Keep the site simple and maintainable.
+- Prefer conventional web technologies over unnecessary frameworks.
+- Avoid dependencies unless they provide a clear benefit.
+- Preserve accessibility, responsive design and fast page loads.
+- Reuse shared styles and components where practical.
+- Keep each application page focused on what the application does.
+- Do not describe Hudra as a general-purpose editor.
+- Treat Hudra primarily as a presentation and slide-viewing system for QLearn.
+- Do not expose secrets, credentials or server-specific private data.
+- Keep deployment configuration documented and reproducible.
+
+## Expected workflow
+
+1. Review existing documentation before changing architecture.
+2. Make focused changes.
+3. Test locally where possible.
+4. Update documentation when behaviour or structure changes.
+5. Commit using a clear, descriptive message.
+
+## Project structure
+
+The final structure will be documented after the existing website is imported and audited.
+
+Do not invent a new architecture before inspecting the existing site.
@@ -0,0 +1,20 @@
+# Napper Website
+
+Source code and deployment configuration for the Napper website and application ecosystem.
+
+## Websites
+
+- <https://napper.au>
+- <https://napper.au/hudra>
+- <https://napper.au/lildra>
+- <https://napper.au/pendra>
+
+## Repository philosophy
+
+The repository is the source of truth, not the conversation.
+
+Important architectural, development and deployment decisions must be recorded in the repository so that future contributors and AI coding sessions inherit the correct project context.
+
+## Current status
+
+The repository has been created and is being prepared for the import of the existing `napper.au` website.
@@ -0,0 +1,32 @@
+# Operating system files
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Editors
+.vscode/*
+!.vscode/extensions.json
+!.vscode/settings.json
+.idea/
+
+# Temporary files
+*.tmp
+*.temp
+*.log
+*.bak
+*.swp
+
+# Environment and secrets
+.env
+.env.*
+!.env.example
+
+# Dependencies and generated output
+node_modules/
+vendor/
+dist/
+build/
+.cache/
+
+# Deployment files
+.deploy/