Skip to content

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.

License

Notifications You must be signed in to change notification settings

nelsongraa8/angular-dev-enhanced

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🅰️ Angular Dev Enhanced

Docker npm version MIT License

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):
    pnpm test
  • End-to-End (Playwright):
    pnpm test:e2e

🐳 Docker

  • Desarrollo:

    pnpm docker:dev

    Levanta el entorno con hot-reload dentro de un contenedor.

  • Producción:

    pnpm docker:prod

    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

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

📜 Licencia

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

About

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.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published