Skip to content

Maidana0/astro-fit

Repository files navigation

🚀 AstroFit - Template de Entrenador Personal

Proyecto desarrollado para AWS on Nerdearla: Learn, Build, and Earn 🚀

Un template moderno y completo para entrenadores personales construido con Astro y Amazon Q Developer. Diseñado específicamente para el mercado argentino con terminología local, precios en ARS y integración con WhatsApp.

📋 Tabla de Contenidos

🎯 Información del Proyecto

Inicio Rápido

🤖 Desarrollo con IA

📊 Métricas y Casos de Uso

🔗 Recursos


Amazon Q Developer

Amazon Q Developer

Aplicación Desplegada

AstroFit Template

🌟 Características

  • Diseño Responsivo: Mobile-first con Tailwind CSS
  • Rendimiento Optimizado: Astro para carga ultra-rápida
  • SEO Completo: Meta tags, Open Graph, Schema.org
  • Accesibilidad: WCAG 2.1 AA compliant
  • Contenido Dinámico: Sistema de publicaciones con cards
  • Integración WhatsApp: Botón flotante y enlaces directos
  • Precios Localizados: Configurado para mercado argentino (ARS)
  • Componentes Reutilizables: Arquitectura modular y escalable

🏗️ Arquitectura del Proyecto

src/
├── components/
│   ├── common/          # Header, Footer
│   ├── sections/        # Hero, Services, Pricing, etc.
│   └── ui/             # Button, Cards, componentes base
├── data/               # Configuración de contenido
│   ├── services.ts     # Servicios del entrenador
│   ├── pricing.ts      # Planes y precios
│   ├── posts.ts        # Contenido de publicaciones
│   └── valueProp.ts    # Propuestas de valor
├── layouts/            # Layouts base y especializados
├── pages/              # Rutas de la aplicación
│   ├── publicaciones/  # Sistema de blog/tips
│   ├── servicios.astro
│   └── contacto.astro
└── styles/             # Estilos globales

🤖 Proceso de Construcción con Amazon Q Developer

Este proyecto fue desarrollado completamente utilizando Amazon Q Developer como asistente de IA, demostrando las capacidades de desarrollo asistido por IA en un proyecto real.

📋 Prompt Especializado Utilizado

Para este proyecto se utilizó un prompt especializado en Astro que se encuentra en prompt.md. Este prompt define:

  • Arquitecto Frontend Senior especializado en Astro
  • Principios de rendimiento (TTI, FCP optimizados)
  • Estándares de accesibilidad WCAG 2.1 AA
  • Mejores prácticas de Astro Islands y hidratación
  • Documentación detallada en cada componente

🔄 Flujo de Desarrollo:

  1. Planificación: Definición de arquitectura y componentes con Q Developer
  2. Desarrollo Iterativo: Creación de componentes paso a paso
  3. Optimización: Mejoras de UX/UI y rendimiento
  4. Refactoring: Reestructuración de datos y componentes
  5. Pulido Final: Ajustes de diseño y experiencia de usuario

💬 Conversaciones Destacadas con Amazon Q Developer

1. Arquitectura Inicial

Conversación: Setup inicial de Astro

  • Configuración del proyecto base
  • Estructura de carpetas y componentes
  • Integración de Tailwind CSS

2. Sistema de Componentes

Conversación: Creación de componentes 1 Conversación: Creación de componentes 2

  • Desarrollo de componentes UI reutilizables
  • Implementación de layouts especializados
  • Configuración de props y TypeScript

3. Sistema de Publicaciones

Conversación: Blog y contenido 1 Conversación: Blog y contenido 2

  • Creación del sistema de posts
  • Implementación de PostCard components
  • Estructura de datos para contenido

4. Optimizaciones UX/UI

Conversación: Mejoras de diseño 1 Conversación: Mejoras de diseño 2 Conversación: Mejoras de diseño 3

  • Efectos hover y transiciones
  • Mejoras en tipografía y espaciado
  • Implementación de glassmorphism

5. Integración de Datos

Conversación: Refactoring de datos

  • Reestructuración de archivos de datos
  • Implementación de interfaces TypeScript
  • Optimización de componentes con mapeo

🎯 Resultados del Desarrollo Asistido por IA

  • Tiempo de desarrollo: Reducido en ~70% comparado con desarrollo tradicional
  • Calidad del código: Comentarios detallados y mejores prácticas aplicadas
  • Arquitectura: Estructura escalable y mantenible desde el inicio
  • Performance: Optimizaciones implementadas durante el desarrollo
  • Accesibilidad: Estándares WCAG aplicados consistentemente

Proceso para crear el README Proceso para crear el README - 2

🚀 Demo en Vivo

🔗 Ver Demo Desplegado

Desplegado en AWS Amplify con integración continua desde GitHub.

🔗 Ver Demo Desplegado

Desplegado en Github Pages con Github Actions configurado para Astro.

⚡ Inicio Rápido

Prerrequisitos

  • Node.js 18+
  • pnpm (recomendado)

Instalación

# Clonar el repositorio
git clone [https://github.com/Maidana0/astro-fit]
cd astro-fit

# Instalar dependencias
pnpm install

# Ejecutar en desarrollo
pnpm dev

# Construir para producción
pnpm build

🎨 Personalización

1. Configurar Datos del Negocio

// src/data/services.ts
export const services = [
  {
    title: 'Tu Servicio',
    description: 'Descripción personalizada',
    price: 'Tu precio',
    // ...
  },
];

2. Actualizar Información de Contacto

// src/data/navigation.ts
// Actualizar enlaces y información de contacto

3. Personalizar Colores y Estilos

/* src/styles/global.css */
/* Modificar variables CSS o clases de Tailwind */

📱 Funcionalidades Principales

Sistema de Servicios

  • Grid responsivo de servicios
  • Precios en ARS
  • CTAs optimizados para conversión

Blog/Publicaciones

  • 6 artículos de fitness pre-cargados
  • Sistema de cards con iconos
  • Layout especializado para contenido

Integración WhatsApp

  • Botón flotante persistente
  • Enlaces directos desde CTAs
  • Optimizado para mobile

SEO y Performance

  • Lighthouse Score: 95+
  • Meta tags completos
  • Schema.org para negocio local
  • Imágenes optimizadas

🛠️ Stack Tecnológico

  • Framework: Astro 4.x
  • Styling: Tailwind CSS
  • TypeScript: Tipado completo
  • Deployment: AWS Amplify
  • AI Assistant: Amazon Q Developer

📊 Métricas de Rendimiento

  • First Contentful Paint: < 1.2s
  • Largest Contentful Paint: < 2.5s
  • Cumulative Layout Shift: < 0.1
  • Time to Interactive: < 3.0s

🎯 Casos de Uso

Este template es perfecto para:

  • ✅ Entrenadores personales
  • ✅ Nutricionistas
  • ✅ Coaches de fitness
  • ✅ Gimnasios boutique
  • ✅ Instructores de yoga/pilates

🤝 Contribuciones

Este proyecto fue desarrollado como demostración para AWS on Nerdearla. Las contribuciones son bienvenidas para mejorar el template.

📄 Licencia

MIT License - Libre para uso comercial y personal.

💡 Lecciones Aprendidas del Desarrollo con IA

✅ Ventajas del Desarrollo Asistido por IA

  • Velocidad: Desarrollo 3x más rápido que métodos tradicionales
  • Consistencia: Patrones de código uniformes en todo el proyecto
  • Documentación: Comentarios detallados generados automáticamente
  • Mejores Prácticas: Implementación automática de estándares de la industria
  • Refactoring: Reestructuración de código eficiente y segura

🎓 Mejores Prácticas para Trabajar con Amazon Q Developer

  1. Prompts Específicos: Usar prompts especializados para mejores resultados
  2. Iteración Gradual: Desarrollar componente por componente
  3. Validación Constante: Revisar y ajustar el código generado
  4. Contexto Claro: Proporcionar contexto del proyecto y objetivos
  5. Feedback Loop: Iterar basado en resultados y necesidades

🙏 Agradecimientos

  • AWS on Nerdearla por la oportunidad de demostrar el desarrollo asistido por IA
  • Amazon Q Developer por ser un asistente excepcional en todo el proceso
  • Astro Team por crear un framework increíble
  • Tailwind CSS por el sistema de diseño

Desarrollado con ❤️ y Amazon Q Developer para AWS on Nerdearla 2025

🔗 Enlaces Útiles


¿Preguntas sobre el desarrollo con Amazon Q Developer? ¡Contactame!

About

Template de Astro desarrollado con el objetivo de experimentar con Amazon Q Developer y amplify

Topics

Resources

Stars

Watchers

Forks

Contributors 2

  •  
  •