Proceso interno

Guia de Contribucion

Esta guia esta pensada para el equipo de Citriom. Aqui tienen el flujo recomendado para crear, validar y publicar nuevas ideas HTML dentro del catalogo.

1. Crear la idea

Agrega un archivo Markdown en src/content/projects/ con un nombre descriptivo, por ejemplo saas-analytics-moderno.md.

---
title: "Nombre del Proyecto"
author: "Nombre del Equipo"
date: 2026-03-18
tags: ["saas", "landing", "responsive"]
preview: "/projects/nombre-proyecto.jpg"
description: "Resumen breve del concepto"
---

## Concepto

Describe la idea principal.

## Caracteristicas

- Punto clave 1
- Punto clave 2
- Punto clave 3

2. Donde va cada cosa

Esta es la estructura recomendada para que todo funcione bien en el catalogo.

src/content/projects/
  mi-proyecto.md              # Ficha del proyecto (obligatorio)

public/projects/
  mi-proyecto.jpg             # Imagen preview (recomendado)
  mi-proyecto.zip             # Entregable comprimido (opcional)
  mi-proyecto/
    demo/
      index.html              # Demo navegable (opcional)
      styles.css
      script.js

Regla importante: no colocar index.html directo en public/projects/mi-proyecto/, porque eso puede sobrescribir la ruta dinamica /projects/[slug].

Si quieren publicar HTML/CSS/JS ejecutable, coloquenlo en public/projects/mi-proyecto/demo/ y usen index.html como entrada.

Luego pueden referenciarlo dentro del markdown con un link como: [Ver demo](/projects/mi-proyecto/demo/index.html).

3. Subir assets

Coloca previews en public/projects/. Recomendado: 1200x675. Si una imagen no existe, la tarjeta mostrara automaticamente un placeholder.

Ruta sugerida de imagen: /projects/nombre-proyecto.jpg

4. Validar en local

npm install
npm run dev
npm run build

Antes de publicar, revisen que la card aparezca en home, que el detalle cargue en /projects/[slug], y que el link demo abra /projects/[slug]/demo/index.html.

5. Publicar cambios

git checkout -b feat/nueva-idea
git add .
git commit -m "feat: agregar nueva idea"
git push origin feat/nueva-idea

Si trabajan con PR, publiquen la rama y abran el pull request con resumen y capturas.

Si el flujo interno es directo, pueden hacer push a main despues de validar local.