https://github.com/sergiomarquezdev/cv-portfolio-dev
👨💻 CV - Portfolio personal de Sergio Márquez, minimalista y optimizado, construido con Astro y Tailwind CSS. Muestra mi experiencia como Desarrollador Full Stack e IA/ML, proyectos y habilidades, siguiendo el principio KISS (Keep It Simple, Stupid) con foco en rendimiento y simplicidad.
https://github.com/sergiomarquezdev/cv-portfolio-dev
astro desarrollador portfolio
Last synced: about 1 month ago
JSON representation
👨💻 CV - Portfolio personal de Sergio Márquez, minimalista y optimizado, construido con Astro y Tailwind CSS. Muestra mi experiencia como Desarrollador Full Stack e IA/ML, proyectos y habilidades, siguiendo el principio KISS (Keep It Simple, Stupid) con foco en rendimiento y simplicidad.
- Host: GitHub
- URL: https://github.com/sergiomarquezdev/cv-portfolio-dev
- Owner: sergiomarquezdev
- Created: 2024-09-03T13:04:58.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-09-10T15:43:29.000Z (10 months ago)
- Last Synced: 2025-09-10T18:34:49.269Z (10 months ago)
- Topics: astro, desarrollador, portfolio
- Language: Astro
- Homepage: https://cv.sergiomarquez.dev
- Size: 9.03 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CV - Portfolio de Sergio Márquez - cv.sergiomarquez.dev
## 🎯 Descripción
CV - Portfolio personal **minimalista y optimizado**, construido con **Astro** y **Tailwind CSS**. Muestra mi experiencia como Desarrollador Full Stack e IA/ML, proyectos y habilidades, siguiendo el **principio KISS** (Keep It Simple, Stupid) con foco en rendimiento y simplicidad.
## ✨ Características Principales
- **Rendimiento Optimizado:** Carga ultra rápida con Astro, optimización de imágenes y Lighthouse >95.
- **Diseño Profesional:** Interfaz minimalista, responsive (Mobile-first) con Tailwind CSS y animaciones CSS.
- **Experiencia de Usuario Mejorada:** Animaciones de entrada, resaltado de navegación y transiciones suaves.
- **Gestión de Datos y SEO:** CV en JSON, TypeScript, sitemap automático y metadatos optimizados.
- **Toolchain Minimalista:** Bun para velocidad superior, Biome para linting/formatting unificado.
- **Principio KISS:** Setup simplificado sin sobreingeniería, enfocado en funcionalidad esencial.
- **Deploy Automático:** Despliegue automático con Cloudflare Pages al detectar commits.
## 🛠️ Stack Tecnológico Principal
- **Core:** Astro (v5.13.5), TypeScript (v5.9.2), Tailwind CSS (v3.4.17)
- **Herramientas:** Bun (v1.2.21), Biome (v2.2.2)
- **Integraciones Astro:** Tailwind CSS, Partytown, Sitemap, Check
- **Optimización:** LightningCSS, Terser
## 🚀 Inicio Rápido
### Desarrollo Local (Recomendado - con Bun)
1. **Clonar:** `git clone https://github.com/sergiomarquezdev/cv-portfolio-dev.git && cd cv-portfolio-dev`
2. **Instalar Bun:** [Instrucciones oficiales](https://bun.sh/)
3. **Instalar dependencias:** `bun install` (17x más rápido que npm)
4. **Desarrollo:** `bun dev` (Visita `http://localhost:4321`)
### Alternativa con npm/Node.js
1. **Clonar:** `git clone https://github.com/sergiomarquezdev/cv-portfolio-dev.git && cd cv-portfolio-dev`
2. **Instalar:** `npm install`
3. **Desarrollo:** `npm run dev` (Visita `http://localhost:4321`)
## 📦 Scripts Disponibles (Simplificados - Principio KISS)
### Con Bun (Recomendado)
| Comando | Descripción |
| -------------------- | ------------------------------------- |
| `bun dev` | Inicia servidor de desarrollo. |
| `bun run build` | Compila el proyecto para producción. |
| `bun run preview` | Previsualiza la build de producción. |
| `bun run type-check` | Verificación de tipos con TypeScript. |
| `bun run lint` | Verifica calidad de código con Biome. |
| `bun run format` | Formatea código con Biome. |
### Con npm (Compatibilidad)
| Comando | Descripción |
| -------------------- | ------------------------------------- |
| `npm run dev` | Inicia servidor de desarrollo. |
| `npm run build` | Compila el proyecto para producción. |
| `npm run preview` | Previsualiza la build de producción. |
| `npm run type-check` | Verificación de tipos con TypeScript. |
| `npm run lint` | Verifica calidad de código con Biome. |
| `npm run format` | Formatea código con Biome. |
## 🌐 Despliegue en Cloudflare Pages
Este proyecto está optimizado para Cloudflare Pages con los siguientes archivos de configuración:
- **`.nvmrc`**: Especifica Node.js v22.18.0
- **`package-lock.json`**: Garantiza versiones consistentes de dependencias
- **`wrangler.toml`**: Configuración de build para Cloudflare
- **`public/_headers`**: Headers de seguridad y cache optimizado
### Configuración en Cloudflare Pages:
1. **Build command:** `npm run build`
2. **Build output directory:** `dist`
3. **Node.js version:** Se detecta automáticamente desde `.nvmrc`
## 🛠️ Herramientas de Desarrollo (Simplificadas)
- **Biome:** Linting y formatting unificado, reemplaza ESLint + Prettier
- **TypeScript:** Verificación de tipos estricta con Astro Check
- **Astro:** Framework estático optimizado para rendimiento
- **Tailwind CSS:** Styling utility-first para desarrollo rápido
> **Principio KISS Aplicado:** Este proyecto sigue el principio "Keep It Simple, Stupid" - solo las herramientas esenciales, sin sobreingeniería.
## 🎯 Filosofía del Proyecto: Principio KISS
Este proyecto ha sido **simplificado radicalmente** siguiendo el principio KISS (Keep It Simple, Stupid):
- **Eliminación de Sobreingeniería:** Sin CI/CD complejo, hooks innecesarios o scripts de mantenimiento
- **Solo lo Esencial:** 6 scripts únicamente, herramientas mínimas pero potentes
- **Funcionalidad Completa:** Mantiene todas las capacidades necesarias sin complejidad adicional
- **Deploy Automático:** Cloudflare Pages maneja el despliegue automáticamente
### Beneficios del Stack Minimalista
- **Bun:** Instalación de dependencias ultra rápida para desarrollo
- **Biome:** Herramienta única para linting y formatting
- **Astro:** Framework optimizado sin JavaScript innecesario en el cliente
- **Mantenimiento Mínimo:** Menos configuración, menos problemas
## 🧹 Historial de Simplificación
**Enero 2025**: Simplificación radical siguiendo el principio KISS
- ✅ Eliminadas 1,156+ líneas de código innecesario
- ✅ Reducida complejidad en 85% sin pérdida de funcionalidad
- ✅ Scripts reducidos de 39 a 6 esenciales
- ✅ Eliminados: GitHub Actions, Husky hooks, scripts de mantenimiento
- ✅ Mantenido: Funcionalidad completa y deploy automático
> Ver documentación completa del proceso en `/docs/implementation-plan/overengineering-analysis.md`
## 📝 Licencia
Licencia MIT. Ver archivo `LICENSE` para más detalles.
## 📬 Contacto
Sergio Márquez - [@sergiomarquezp_](https://x.com/sergiomarquezp_) - sergiomarqueztech@gmail.com
Enlace del proyecto: [https://github.com/sergiomarquezdev/cv-portfolio-dev](https://github.com/sergiomarquezdev/cv-portfolio-dev)
---
