🧪 RegistroLab

Gestión moderna de pacientes y registros de laboratorio

🐛 Reportar bug · 💡 Solicitar feature

---

📖 Descripción

RegistroLab es una aplicación web para la gestión de pacientes y registros de laboratorio, construida con un stack moderno centrado en rendimiento y experiencia de usuario. Ofrece autenticación segura mediante Clerk, una interfaz adaptable con TailwindCSS y un despliegue optimizado gracias a Astro.

Ideal como base sólida para proyectos que requieran autenticación, diseño responsive y despliegue eficiente en la nube.

---

✨ Características

• 🔐 Autenticación segura con Clerk (login, registro, gestión de sesiones)
• 🎨 UI moderna y responsiva usando TailwindCSS
• ⚡ Rendimiento óptimo gracias a la arquitectura de islas de Astro
• 🗂️ Gestión de registros de pacientes de laboratorio
• 🌍 Desplegado en Vercel con integración continua

---

🛠️ Stack tecnológico

Tecnología	Uso
Astro	Framework principal de frontend
TailwindCSS	Estilos utilitarios y diseño
Clerk	Autenticación y gestión de usuarios
Supabase	Base de datos y backend (PostgreSQL)
TypeScript	Tipado estático
pnpm	Gestor de paquetes

---

🚀 Inicio rápido

Prerrequisitos

• Node.js >= 18
• pnpm instalado globalmente

npm install -g pnpm

Instalación

# 1. Clonar el repositorio
git clone https://github.com/irvingpoot/RegistroLab.git
cd RegistroLab

# 2. Instalar dependencias
pnpm install

# 3. Configurar variables de entorno
cp .env.example .env

Variables de entorno

Crea un archivo .env en la raíz del proyecto con las siguientes claves (obtenidas desde el dashboard de Clerk):

PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...

PUBLIC_SUPABASE_URL=https://xxxx.supabase.co
PUBLIC_SUPABASE_ANON_KEY=eyJ...

Ejecutar en desarrollo

pnpm dev

Abre http://localhost:4321 en tu navegador 🎉

---

📜 Scripts disponibles

pnpm dev        # Servidor de desarrollo con hot-reload
pnpm build      # Compilación optimizada para producción
pnpm preview    # Vista previa del build de producción
pnpm astro      # CLI de Astro para tareas adicionales

---

📂 Estructura del proyecto

RegistroLab/
├── public/                 # Archivos estáticos (favicon, imágenes públicas)
├── src/
│   ├── assets/             # Recursos (imágenes, íconos, fuentes)
│   ├── components/         # Componentes reutilizables de UI
│   ├── layouts/            # Plantillas base de las páginas
│   └── pages/              # Rutas y páginas del sitio
├── .env                    # Variables de entorno (no commitear)
├── astro.config.mjs        # Configuración de Astro
├── tailwind.config.js      # Configuración de TailwindCSS
├── tsconfig.json           # Configuración de TypeScript
└── package.json            # Dependencias y scripts

---

🚢 Despliegue

El proyecto está configurado para desplegarse en Vercel de forma automática.

1. Conecta tu repositorio en vercel.com
2. Agrega las variables de entorno en el panel de Vercel
3. ¡Listo! Cada push a main desplegará automáticamente

---

🔗 Versiones del proyecto

Versión	Repositorio	Descripción
🖥️ Desktop	RegistroLab - Desktop	App instalable para Windows
🌐 Web	Este repositorio	Desplegada en Vercel

---

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Si tienes ideas o encuentras algún bug:

1. Haz fork del repositorio
2. Crea una rama: git checkout -b feature/mi-nueva-feature
3. Commitea tus cambios: git commit -m 'feat: agrega nueva feature'
4. Haz push: git push origin feature/mi-nueva-feature
5. Abre un Pull Request

---

👤 Autor

Irving Poot

---

_{Hecho con ❤️ usando Astro + TailwindCSS + Clerk + Supabase}