Skip to content

Installation Setup

Crypt0xDev edited this page Nov 2, 2025 · 1 revision

🛠️ Instalación y Setup

🎯 Requisitos del Sistema

📋 Prerrequisitos

Software Versión Mínima Versión Recomendada Instalación
Node.js 18.20.8 20.x LTS nodejs.org
pnpm 7.1.0 Latest npm install -g pnpm
Git 2.25.0 Latest git-scm.com
VS Code 1.80+ Latest code.visualstudio.com

🔍 Verificar Instalación

# Verificar versiones
node --version    # v20.x.x
pnpm --version    # 8.x.x
git --version     # git version 2.x.x

🚀 Instalación Rápida (5 minutos)

1️⃣ Clonar Repositorio

# Opción A: SSH (recomendado si tienes SSH keys)
git clone git@github.com:Crypt0xDev/Crypt0.git
cd Crypt0

# Opción B: HTTPS
git clone https://github.com/Crypt0xDev/Crypt0.git
cd Crypt0

2️⃣ Instalar Dependencias

# Instalar con pnpm (más rápido)
pnpm install

# O con npm (si prefieres)
npm install

3️⃣ Iniciar Desarrollo

# Servidor de desarrollo
pnpm dev

# ✅ Servidor disponible en:
# Local:   http://localhost:4321/
# Network: http://192.168.x.x:4321/

⚙️ Configuración de VS Code

📦 Extensiones Esenciales

# Extensiones recomendadas para el proyecto
code --install-extension astro-build.astro-vscode
code --install-extension bradlc.vscode-tailwindcss
code --install-extension esbenp.prettier-vscode
code --install-extension ms-vscode.vscode-typescript-next

Lista manual:

  • Astro (astro-build.astro-vscode)
  • Tailwind CSS IntelliSense (bradlc.vscode-tailwindcss)
  • Prettier (esbenp.prettier-vscode)
  • TypeScript (ms-vscode.vscode-typescript-next)

🔧 Configuraciones Avanzadas

🌐 Variables de Entorno

# .env.local
SITE_URL=http://localhost:4321
ASTRO_TELEMETRY_DISABLED=1

📝 Configuración de Git

# Configurar usuario (si es primera vez)
git config user.name "Tu Nombre"
git config user.email "tu.email@ejemplo.com"

# Configurar rama por defecto
git config init.defaultBranch main

🧪 Verificación de Setup

# 1. Verificar que el servidor inicia sin errores
pnpm dev

# 2. Verificar build de producción
pnpm build

# 3. Verificar linting
pnpm lint || echo "Lint command not configured"

🐛 Troubleshooting Común

❌ Error: Command not found

# Si pnpm no se encuentra
npm install -g pnpm@latest

❌ Error: Port already in use

# Usar puerto diferente
pnpm dev --port 3000

❌ Error: Hot reload no funciona

# Recargar ventana de VS Code
Ctrl+Shift+P > "Developer: Reload Window"

🚀 Próximos Pasos

Una vez completada la instalación:

  1. 📖 Lee la Guía para Nuevos Usuarios
  2. 🤝 Aprende a Contribuir
  3. 📝 Crea tu Primer Post