chore: initialise Napper website repository
This commit is contained in:
@@ -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/
|
||||||
Reference in New Issue
Block a user