https://github.com/capitec/template-pwa-angular
https://github.com/capitec/template-pwa-angular
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/capitec/template-pwa-angular
- Owner: capitec
- License: mit
- Created: 2023-06-23T06:39:42.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-01-11T10:51:13.000Z (over 2 years ago)
- Last Synced: 2025-02-23T10:41:25.137Z (over 1 year ago)
- Language: HTML
- Size: 471 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Introduction
Progressive Web App (PWA) starter template for [Angular](https://angular.io/)-based Single-page application (SPA) development, leveraging [Omni Components](https://github.com/capitec/omni-components) library.
# Usage
1️⃣ Create a new [repository from this template](https://github.com/capitec/template-pwa-angular/generate) (or fork) and clone locally:
```bash
git clone https://github.com/{your-repo-name}.git
cd {your-repo-name}
```
2️⃣ Restore all package dependencies:
```bash
npm i
```
3️⃣ Open it in VS Code:
```bash
code .
```
# Scripts
The following NPM scripts within `package.json` should be noted:
- `serve` - Launches Angular's dev server (Automated via F5 debugging in VS Code 😎).
- `build` - Bundles code and copies artifacts for production from the `src` directory to the `dist` directory.
- `preview` - Launches a simple web server, serving the `dist` directory (Remember to `build` first! 🎗️).
- `test` - Launches the [Angular](https://angular.io/guide/testing) test runner & executes all tests.
- `format` - Runs the Prettier formatter on all `.ts` files, applying format updates where necessary.
- `lint`- Runs the ESLint analyzer on all `.ts` files, applying code updates where necessary.
# Features
| Feature | Availability | Description |
|-------------------------------|-----|-----------------------------------------------------------------|
| Components | ✅ | [Omni Components](https://github.com/capitec/omni-components) |
| Component Intellisense | ✅ | |
| Routing | ✅ | [Angular](https://angular.io/guide/routing-overview) |
| VS Code Debugging | ✅ | [.vscode/launch.json](./.vscode/launch.json) |
| Tests | ✅ | [Angular](https://angular.io/guide/testing) |
| Serve | ✅ | [Angular CLI](https://angular.io/cli) |
| Build | ✅ | [Angular CLI](https://angular.io/cli) |
| Build chunking | ✅ | `/* webpackChunkName: */` compiler hints |
| Preview built output | ✅ | [http-server](https://github.com/http-party/http-server) |
| Formatting | ✅ | [Prettier](https://prettier.io/) |
| Linting | ✅ | [ESLint](https://eslint.org/) |