Welcome to My Documentation
This site contains the detailed documentation for my portfolio architecture, homelab infrastructure, portfolio tech stack, CI/CD pipelines, and troubleshooting guides.
I have documented i have learned for my devops journey and some other stuff as well. Every problems i ran into and how i fixed it.
Please select a topic from the navigation bar above to get started.
NOTE : These documentations are created from my raw obsidian notes that i made during the building process, i just can't spend my time in decorating my documentation rather than learning some good stuff. But it is not AI slop. I refer to these documentation myself to understand how i built something and how can i improve it.
📚 Documentation Index
🏛️ Architecture & Project Structure
| Topic | Description | Link |
|---|---|---|
| Homelab Infrastructure | Server setup, self-hosting environment & networking | Open Note |
| Astro SSG | Static Site Generation architecture & core concepts | Open Note |
| DaisyUI | Component library integration & UI tokens | Open Note |
| Tailwind CSS | Utility styling configuration & custom themes | Open Note |
| Components | Reusable UI components breakdown | Open Note |
| Content Collections | Type-safe Markdown and content schema management | Open Note |
| Layouts | Base page templates & slot wrappers | Open Note |
| Routing | File-based routing & dynamic pages | Open Note |
| Public Assets | Static fonts, icons, and asset handling | Open Note |
🐳 Docker & Multi-Stage Builds
| Topic | Description | Link |
|---|---|---|
| Stage 1: Builder | Node build environment, dependencies & caching | Open Note |
| Stage 2: Runner | Minimal runtime environment & static serving | Open Note |
| Optimisations | Layer caching, image size reduction & build speed | Open Note |
🚀 CI/CD Pipelines (GitHub Actions)
| Topic | Description | Link |
|---|---|---|
| Build & Push Job | Automated Docker image building and GHCR push | Open Note |
| Deploy Job | Production server deployment & webhook triggers | Open Note |
🛠️ Troubleshooting & Fixes
| Issue / Fix | Summary | Link |
|---|---|---|
| Astro Build Failures | Debugging build-time syntax and bundle errors | Open Note |
| Caddy Reverse Proxy | Reverse proxy headers, SSL & host routing | Open Note |
| GHCR 403 Forbidden | Fixing container registry authentication & permissions | Open Note |
| Handle Block Cleanup | Resolving runner disk space & stale container locks | Open Note |
| Manage Actions Access | Granting write permissions to workflow tokens |
Open Note |
| Personal Access Tokens (PAT) | Token scopes, secrets setup & rotation | Open Note |