GitHub - nelsongraa8/angular-dev-enhanced: This repository provides an initial Angular setup with additional development libraries such as Vite and Vitest. It is also preconfigured with ESLint and Prettier to encourage good coding practices. Ideal for developers looking for a solid starting point for their Angular projects.

🅰️ Angular Dev Enhanced

Plantilla profesional de Angular lista para desarrollo, CI/CD y Docker, con las mejores prácticas y herramientas integradas.

✨ Características

Angular (última versión) con configuración optimizada.
Jest para tests unitarios.
Playwright para tests end-to-end (E2E).
Husky + Commitlint para control de commits estandarizados.
ESLint con reglas estrictas y buenas prácticas.
Prettier para formato de código.
Docker listo para desarrollo y producción.
Scripts de automatización para tareas comunes.
Soporte para pnpm (recomendado) o npm.

📦 Requisitos

Node.js 22+
pnpm (recomendado) o npm
Docker (opcional, recomendado para entornos homogéneos)

🚀 Instalación

git clone https://github.com/<tu-usuario>/angular-dev-enhanced.git
cd angular-dev-enhanced
pnpm install

🛠️ Scripts principales

Comando	Descripción
`pnpm start`	Inicia el servidor de desarrollo con HMR
`pnpm build`	Compila para producción
`pnpm test`	Ejecuta tests unitarios con Jest
`pnpm test:e2e`	Ejecuta tests E2E con Playwright
`pnpm lint`	Ejecuta ESLint
`pnpm format`	Formatea el código con Prettier
`pnpm commit`	Asistente de commit (Commitlint + Husky)
`pnpm docker:dev`	Entorno Docker para desarrollo
`pnpm docker:prod`	Construye y levanta el contenedor de producción

🧪 Testing

Unitarios (Jest):
End-to-End (Playwright):

🐳 Docker

Desarrollo:

Levanta el entorno con hot-reload dentro de un contenedor.
Producción:

Genera la imagen optimizada para producción.

🧹 Calidad de código

Husky: Ejecuta hooks en cada commit para garantizar calidad.
Commitlint: Valida mensajes de commit siguiendo Conventional Commits.
ESLint y Prettier: Integrados para estilo y buenas prácticas.

📂 Estructura recomendada

src/
  app/
    core/          # Servicios, guardas y lógica central
    shared/        # Componentes y utilidades compartidas
    features/      # Módulos de funcionalidades
tests/             # Configuración y utilidades para testing

🤝 Contribuir

Haz un fork del repositorio.
Crea una rama para tu feature o fix:
```
git checkout -b feature/mi-feature
```
Realiza tus cambios y haz commit siguiendo las reglas de commitlint.
Abre un Pull Request.

📜 Licencia

Este proyecto está bajo la licencia MIT. Puedes usarlo y adaptarlo libremente.