Ressa Documentation 🦖

This repository contains the source code for the Ressa HomeLab Documentation site, accessible at docusaurus.ressa.ro.

Built with Docusaurus, this project serves as the central knowledge base for my infrastructure, including Kubernetes cluster details, Helm chart documentation, and CI/CD workflows.

🚀 Pipeline Architecture

The project follows a "Documentation as Code" philosophy with a fully automated deployment pipeline:

1. Source Control (Forgejo): The primary development happens on the main branch of my private Forgejo instance.
2. Continuous Integration: Forgejo Actions (using Node.js 20) triggers on every push to main, running npm run build.
3. Artifact Management: Optimized static HTML files are pushed to an orphan branch named docusaurus-html.
4. Mirroring: The docusaurus-html branch is mirrored to GitHub.
5. Edge Hosting: Cloudflare Pages monitors the GitHub mirror and serves the static assets globally.

🛠 Local Development

To preview changes locally before pushing:

# Install dependencies
npm install

# Start the development server
npm start

# Build for production
npm run build

The local server usually runs at http://localhost:3000.

📂 Project Structure

• docs/infrastructure/: Documentation regarding the underlying hardware and CI/CD pipelines.
• docs/kubernetes/: Details about the hybrid K3s cluster and application deployments.
• docusaurus.config.ts: Main configuration file (Site title, Navbars, Footer).
• sidebars.ts: Navigation structure for the documentation sections.

🔗 Key Links

• Production Site: docusaurus.ressa.ro
• Primary Git Repo: git.ressa.ro
• Helm Chart Repo: git.ressa.ro/.../helm

---

Copyright © 2026 Alexandru Ressa - Built with Docusaurus.