START HERE

This document is the entry point for all development work.

Before implementing any feature, modifying code, generating files, creating migrations, or refactoring existing functionality, read all project documentation.

---

Documentation Reading Order

1. 01-project-overview.md
2. 02-architecture.md
3. 03-database-design.md
4. 04-routing.md
5. 05-ui-pages.md
6. 06-admin-panel.md
7. 07-deployment.md
8. 08-roadmap.md
9. 09-coding-standards.md
10. 10-project-structure.md
11. 11-bootstrap-spec.md

---

Source of Truth

The documentation folder is the authoritative specification.

If code conflicts with documentation:

Documentation wins.

---

Project Goals

Build a:

- Personal Website
- Portfolio
- Technical Blog
- Contact Hub

Using:

- Go
- Fiber
- MariaDB
- Redis
- HTMX
- TinyMCE

---

Development Principles

- Keep implementation simple.
- Avoid over-engineering.
- Prefer maintainability.
- Prefer readability.
- Follow documented architecture.
- Follow documented routing.
- Follow documented database design.

---

Session Recovery

If implementation context is lost:

Stop.

Re-read all documentation files.

Continue implementation only after documentation review.

---

Important

Do not introduce:

- React
- Vue
- Angular
- Next.js
- Nuxt.js
- SPA Architecture

The project uses:

Server Side Rendering (SSR)

with:

Go Templates + HTMX