Luminessa: Alchemist's Workshop / El Taller de Luminessa

---

Choose your language / Elige tu idioma

• English Version
• Versión en Español

---

English Version

Luminessa: Alchemist's Workshop is a digital garden and personal blog where I document the journey through software engineering, self-hosted infrastructure, and the creative alchemy of turning raw code into beautiful, functional digital artifacts.

🏰 Source of Truth

The primary and authoritative repository for this project is self-hosted on a private Luminessa Forgejo instance. This GitHub repository is a mirror maintained for visibility and ecosystem integration.

• Primary Source: https://git.luminessa.net/sophieneuenmuller/luminessa-blog
• GitHub Mirror: https://github.com/sophieneuenmuller/luminessa-blog

Live at: https://blog.luminessa.net

🌐 Project Ecosystem

Luminessa is not just a blog; it's a multi-layered workshop:

• luminessa-landing: The entryway to the workshop. A minimal, high-impact portal to all Luminessa projects.
• luminessa-blog: (This repository) The alchemist's notes and recipes.
• luminessa-infrastructure: Where the deployment and server magic happens. Docker, Caddy, and automation configurations.

🎨 Aesthetic: Cozy Alchemy Workshop

Inspired by the warmth and wonder of an alchemist's workshop (Atelier Sophie style), the blog aims for a "warm afternoon sunlight" atmosphere.

• Palette: Warm Creams (#FAF8F3), Antique Gold (#D4AF37), and Silver flourishes.
• Typography: Scholarly Serif fonts (Crimson Text for body, Cinzel for headers).
• Handcrafted: Custom CSS decorations, SVG flourishes, and a signature CSS-only cauldron in the footer.

🛠️ Technical Stack

• Static Site Generator: Hugo (Extended version).
• Theme: Hugo Theme Stack (submodule).
• Architecture (Zero-Modification Policy): All customizations are implemented via Hugo's override system. The themes/stack/ submodule remains untouched.
• Infrastructure: Self-hosted on a private Hetzner VPS behind a Caddy reverse proxy.

🚀 Getting Started

To explore the workshop locally:

1. Clone the repository (with submodules):

   git clone --recursive https://github.com/Luminessa/luminessa-blog.git
   cd luminessa-blog
   

2. Start the Hugo development server:

   hugo server -D
   

3. Visit the workshop: http://localhost:1313

🛳️ Deployment

This project uses a fully automated CI/CD pipeline:

• Primary Source: Self-hosted on a private Forgejo instance.
• Workflow: Forgejo Actions automatically build the site (hugo --minify) and deploy it to production via rsync upon every push to the main branch.
• Target: Deployed to a production environment at git.luminessa.net.

📜 Policies and Contributing

• License: MIT License (Copyright 2026 Sophie).
• Contributing: Please see CONTRIBUTING.md for guidelines on how to contribute while respecting the Zero-Modification Policy and the Cozy Alchemy aesthetic.

---

Versión en Español

El Taller de Luminessa es un jardín digital y blog personal donde documento mi camino por la ingeniería de software, la infraestructura auto-hospedada y la alquimia creativa de transformar código crudo en artefactos digitales bellos y funcionales.

🏰 Fuente de Verdad

El repositorio primario y con autoridad para este proyecto está auto-hospedado en una instancia privada de Forgejo de Luminessa. Este repositorio en GitHub es un espejo (mirror) mantenido para visibilidad e integración con el ecosistema.

• Fuente Primaria: https://git.luminessa.net/sophieneuenmuller/luminessa-blog
• GitHub Mirror: https://github.com/sophieneuenmuller/luminessa-blog

En vivo en: https://blog.luminessa.net

🌐 Ecosistema del Proyecto

Luminessa no es solo un blog; es un taller de múltiples capas:

• luminessa-landing: La puerta de entrada al taller. Un portal minimalista de alto impacto hacia todos los proyectos de Luminessa.
• luminessa-blog: (Este repositorio) Las notas y recetas de la alquimista.
• luminessa-infrastructure: Donde sucede la magia del despliegue y el servidor. Configuraciones de Docker, Caddy y automatización.

🎨 Estética: Taller de Alquimia Acogedora

Inspirado por el calor y la maravilla de un taller de alquimia (estilo Atelier Sophie), el blog busca una atmósfera de "luz de tarde cálida".

• Paleta: Cremas Cálidos (#FAF8F3), Oro Envejecido (#D4AF37) y floreos de Plata.
• Tipografía: Fuentes Serif académicas (Crimson Text para el cuerpo, Cinzel para encabezados).
• Artesanal: Decoraciones CSS personalizadas, floreos SVG y un caldero insignia hecho solo con CSS en el pie de página.

🛠️ Stack Técnico

• Generador de Sitios Estáticos: Hugo (versión Extended).
• Tema: Hugo Theme Stack (sub-módulo).
• Arquitectura (Política de Cero Modificaciones): Todas las personalizaciones se implementan mediante el sistema de "overrides" de Hugo. El sub-módulo themes/stack/ permanece intacto.
• Infraestructura: Auto-hospedado en un VPS privado de Hetzner detrás de un proxy inverso Caddy.

🚀 Primeros Pasos

Para explorar el taller localmente:

1. Clonar el repositorio (con sub-módulos):

   git clone --recursive https://github.com/Luminessa/luminessa-blog.git
   cd luminessa-blog
   

2. Iniciar el servidor de desarrollo de Hugo:

   hugo server -D
   

3. Visitar el taller: http://localhost:1313

🛳️ Despliegue

Este proyecto utiliza un flujo de CI/CD completamente automatizado:

• Fuente Primaria: Auto-hospedado en una instancia privada de Forgejo.
• Flujo de Trabajo: Forgejo Actions construye automáticamente el sitio (hugo --minify) y lo despliega a producción mediante rsync con cada push a la rama main.
• Destino: Desplegado a un entorno de producción en git.luminessa.net.

📜 Políticas y Contribuciones

• Licencia: Licencia MIT (Copyright 2026 Sophie).
• Contribuciones: Por favor, consulte CONTRIBUTING.md para obtener pautas sobre cómo contribuir respetando la Política de Cero Modificaciones y la estética de Alquimia Acogedora.

---

Created with magic and code in Luminessa's Workshop. / Creado con magia y código en el Taller de Luminessa.