Angular es una plataforma de desarrollo para crear aplicaciones web móviles y de escritorio
utilizando Typescript/JavaScript y otros lenguajes
Este proyecto ha sido genereado con Angular CLI versión 17
Este proyecto trabaja bajo Angular v17 mediante STANDALONE,puede revisar las TAGs o Ramas del respositorio actual para ver las versiones disponibles.
| package use | version |
|---|---|
| Angular CLI | 17.3 |
| Node | 20 |
| Npm | 10 |
Puede seguir el paso a paso para utilizar el arquetipo y/o consultar más detalles sobre su versión y características. ver WIKI
Puede realizar el clonado segun la version y rama respectiva, si no desea conservar historial de commits sugerimos:
git clone --depth=1 --branch <nombre-rama> <URL_DEL_REPO>Ejecute ng serve o npm run start para un servidor de desarrollo. Navegue hasta http://localhost:4200/. La aplicación se recargará automáticamente si cambia alguno de los archivos fuente. Admite componentes independientes.
ng servenpm startEjecute ng generate component component-name --standalone para generar un nuevo componente. También puede usar ng generate directive|pipe|service|class|guard|interface|enum|module. Tenga en cuenta el uso del principio LIFT para Angular, puede ver más información aquí o use la extensión Angular schematics para Visual Studio Code.
Ejecute npm run build para construir el proyecto. Los artefactos de compilación se almacenarán en el directorio dist/.
Para ejecutar las pruebas unitarias a través de JEST. De forma predeterminada, AppComponent evalúa 3 pruebas unitarias. Cada componente debe contener pruebas unitarias y una covertura minima del 70%.
Ejeucte los comandos según corresponda:
npm run testnpm run test:watchnpm run test:coverageESLint y Prettier te ayudan a mantener tu código limpio y legible, lo que a su vez te ayuda a reducir errores y mejorar la calidad de tu código. Por defecto este proyecto ya contiene las configuraciones necesarias, las reglas de ESLint en el archivo .eslintrc.json según las necesidades de Pragma.
Ejeucte los comandos según corresponda:
npm run lintnpm run lint-all npm run lint-watchPara obtener el mejor rendimiento, debes haber instalado y configurado las extensiones necesarias y/o recomendadas:
- ESLint -> vscode-eslint
- Error Lens -> usernamehw.errorlens
- Prettier - Code formatter -> esbenp.prettier-vscode
Para la creación de Branch revise la estrategia de Branching Adecuada para el proyecto. Para la generación de commits haga uso de Conventional Commits puede consultar mas Conventional Commits
Husky es una herramienta que ayuda a gestionar Git hooks en proyectos, permitiendo ejecutar scripts automáticamente antes de commits, pushes u otras acciones de Git. Se usa comúnmente para asegurarse de que el código sigue ciertas reglas antes de ser enviado al repositorio.
Husky suele configurarse para tareas como:
Ejecutar linters o formatters antes de hacer commit (ej. eslint, prettier). Correr pruebas automáticamente antes de hacer push. Evitar commits con errores asegurando que el código cumple ciertos estándares.
🛠️ Hook pre-commit (Husky) Este archivo es un hook de Husky que se ejecuta automáticamente antes de realizar un commit en Git.
🔍 ¿Qué hace?
- Corrige errores de formato (npm run lint:fix).
- Verifica el código con el linter (npm run lint).
- Reagrega archivos después de corregir el formato (git add .).
- Ejecuta pruebas antes del commit (npm run test).
Este proyecto utiliza Compodoc como herramienta de documentación para Angular, basada en JSDoc. Para generar y visualizar la documentación del proyecto, ejecute el siguiente comando:
npm run compodoc:build-and-serveAdemás, puede encontrar información adicional en nuestro espacio de trabajo: Compodoc | Workplace
Para obtener más ayuda sobre Angular CLI, use ng help o consulte la página Angular CLI Overview and Command Reference.
Puede consultar la WIKI del arquetipo. Arquetipo Pragma WIKi
"El talento no solo hay que encontrarlo, hay que guiarlo en la dirección correcta." Pragma
PRAGMA 💜