https://github.com/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.
https://github.com/nelsongraa8/angular-dev-enhanced
Last synced: 13 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/nelsongraa8/angular-dev-enhanced
- Owner: nelsongraa8
- License: apache-2.0
- Created: 2024-06-21T23:30:40.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-11T07:03:21.000Z (3 months ago)
- Last Synced: 2025-08-11T09:20:43.142Z (3 months ago)
- Language: TypeScript
- Size: 1.16 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- fucking-awesome-angular - angular-dev-enhanced - A ready-to-use Angular starter with Vite, Vitest, ESLint, and Prettier—perfect for clean, modern development. (Site Templates / Free Templates)
- awesome-angular - angular-dev-enhanced - A ready-to-use Angular starter with Vite, Vitest, ESLint, and Prettier—perfect for clean, modern development. (Site Templates / Free Templates)
README
# 🅰️ Angular Dev Enhanced
[](https://hub.docker.com/r//angular-dev-enhanced)
[](https://www.npmjs.com/package/angular-dev-enhanced)
[](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+](https://nodejs.org/)
- [pnpm](https://pnpm.io/) (recomendado) o npm
- Docker (opcional, recomendado para entornos homogéneos)
---
## 🚀 Instalación
```bash
git clone https://github.com//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):**
```bash
pnpm test
```
- **End-to-End (Playwright):**
```bash
pnpm test:e2e
```
---
## 🐳 Docker
- **Desarrollo:**
```bash
pnpm docker:dev
```
Levanta el entorno con hot-reload dentro de un contenedor.
- **Producción:**
```bash
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
```plaintext
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:
```bash
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.