Deliver web apps with confidence 🚀
Find a file
Ward Bell 9f3b549cf6 docs: Migrate Service Worker to Standalone (#51687)
Although there are several pages, only `service-worker-getting-started.md` has an example.
That example code was migrated.

Worked around the few references to NgModule.

Other changes as follows:

**Revised "Getting Started"**

The original service worker example page (`service-worker-getting-started.md`) is full of holes! I don’t know how anyone got this working just by following this page

- it doesn’t tell you where to get the example (and it isn’t generated by AIO)
- it doesn’t tell you that ng serve doesn’t support service worker apps
- it mentions http-server in passing but not what that is or where to get it.
- several commands tell you to supply the “project-name” but (a) it doesn’t tell you how to find that name and (b) you never actually have to provide a name at all. That includes on the command that gets http-server going.

**Hid section on `ngsw-config` tool**

Hid the discussion of the `ngsw-config` tool in `service-worker-config.md` because
(a) the command invoke it didn't seem to work and (b) it referenced `<project-name>`
without explaining what that is or where to find it.

Left the hidden text in the page in case someone wants to do something about this.

Meanwhile, you seem to be able to edit the `ngsw-config.json` and then rebuild.
That should suffice.

**Disabled E2E**

The AIO CI will no longer attempt to run the (thin) E2E tests.

These tests could lightly test the app with the dev server but couldn't test the Service Worker aspects; that would require launching the app with something other than `ng serve` and the AIO CI is not set up for that.

The existing tests appeared to pass when run locally with the dev server.
However, only one of them actually ran; test runner reported.
"There were tests whose specified size is too big."

Decided to bypass E2E testing of this project for now.

PR Close #51687
2023-09-19 12:01:16 +02:00
.circleci ci: migrate legacy saucelabs job to Github Actions (#51695) 2023-09-13 10:49:47 -07:00
.devcontainer build: use pin for devcontainer base image (#51556) 2023-08-29 18:38:55 +00:00
.github build: update actions/cache digest to 704facf (#51787) 2023-09-15 11:42:49 +02:00
.husky build: remove unnecessary husky gitignore file (#42870) 2021-07-19 17:31:55 -07:00
.ng-dev build: remove the webworker platform. (#50059) 2023-05-04 09:06:55 +02:00
.vscode build: update recommended launch vscode config to use proper bazel dist path (#47831) 2022-10-24 10:42:21 +02:00
.yarn build: update yarn (#50732) 2023-06-16 10:51:09 +02:00
aio docs: Migrate Service Worker to Standalone (#51687) 2023-09-19 12:01:16 +02:00
devtools build: align with internal tsconfig options (#51728) 2023-09-12 11:39:42 -07:00
docs docs: add MSYS2 to DEVELOPER.md (#51459) 2023-08-22 10:39:23 -07:00
goldens fix(router): Remove malformedUriErrorHandler from ExtraOptions (#51745) 2023-09-18 20:42:44 +02:00
integration fix(zone.js): add conditional exports to zone.js package (#51652) 2023-09-06 16:37:26 +00:00
modules docs: add lang attribute in html files (#51269) 2023-08-21 16:33:43 -07:00
packages fix(router): Remove malformedUriErrorHandler from ExtraOptions (#51745) 2023-09-18 20:42:44 +02:00
scripts build: avoid shallow fetch for benchmark comparison (#50851) 2023-06-26 13:37:38 -07:00
third_party build: create NodeJS ESM loader for supporting Bazel setup (#48521) 2022-12-19 19:50:40 +00:00
tools build: align with internal tsconfig options (#51728) 2023-09-12 11:39:42 -07:00
.bazelignore build: include bazel build file in aio playground code (#51485) 2023-08-23 14:44:03 -07:00
.bazelrc build: migrate project_id option to use bes_instance_name (#51696) 2023-09-07 13:49:07 -07:00
.bazelversion build: update to bazel v5 for new runfiles API used in dev-infra (#45407) 2022-03-21 16:55:36 -07:00
.clang-format feat(tooling): Add a .clang-format for automated JavaScript formatting. 2015-04-02 08:44:34 -07:00
.editorconfig build: use https link to editorconfig.org in .editorconfig (#27664) 2018-12-18 09:30:09 -08:00
.gitattributes build: cleanup .gitattributes file and remove outdated CRLF attribute (#46513) 2022-06-28 13:38:27 -07:00
.gitignore docs: update of landing page and backup pages (#47047) 2022-12-09 16:04:34 -08:00
.gitmessage build: clean up references to old master branch (#45856) 2022-05-04 16:23:33 -07:00
.mailmap build: add a Git .mailmap with my new name (#19550) 2017-10-09 14:35:30 -07:00
.npmrc build: rely on engines to prevent using npm for dependency install (#41477) 2021-04-07 12:05:01 -07:00
.nvmrc build: migrate to node 18 (#51609) 2023-09-01 15:12:43 +00:00
.prettierrc ci: use prettier to format yml files (#42136) 2021-05-19 11:20:20 -07:00
.pullapprove.yml docs: Migrate Universal guide and code to Standalone (#51564) 2023-09-12 12:20:10 -07:00
.yarnrc build: update yarn (#50732) 2023-06-16 10:51:09 +02:00
browser-providers.conf.d.ts build: share Saucelabs browsers between karma test targets using background Saucelabs daemon and custom karma launcher (#49200) 2023-05-15 09:21:46 -07:00
browser-providers.conf.js ci: enable Android 12 for tests on CI (#45926) 2022-05-09 11:26:10 -07:00
BUILD.bazel build: update yarn (#50732) 2023-06-16 10:51:09 +02:00
CHANGELOG.md release: cut the v17.0.0-next.4 release 2023-09-13 10:44:14 -07:00
CHANGELOG_ARCHIVE.md docs: fix typos 2023-06-22 12:56:49 +02:00
CODE_OF_CONDUCT.md build: update CODE_OF_CONDUCT.md to match the content of angular/.github 2023-03-13 21:07:51 +00:00
CONTRIBUTING.md docs: Fix misspelling in note of git commit --all (#51735) 2023-09-12 12:25:42 -07:00
gulpfile.js build: remove the unused source-map-test (#46518) 2022-06-27 15:42:43 -07:00
karma-js.conf.js build: share Saucelabs browsers between karma test targets using background Saucelabs daemon and custom karma launcher (#49200) 2023-05-15 09:21:46 -07:00
LICENSE build: bump license year (#49984) 2023-04-25 09:29:16 -07:00
package.json build: update dependency conventional-changelog to v5 (#51606) 2023-09-15 09:07:04 +02:00
packages.bzl docs: Add rxjs-interop and reactivity primitives APIs (#50066) 2023-05-01 07:53:47 -07:00
README.md docs: updated the i tag with the em tag (#50923) 2023-07-10 07:15:49 -07:00
renovate.json ci: update renovate.json (#49909) 2023-04-18 20:54:28 +00:00
SECURITY.md build: update SECURITY.md to match the content of angular/.github 2023-01-06 08:51:29 +00:00
tsconfig-tslint.json refactor(devtools): run ng-dev format on angular devtools files 2022-01-26 16:35:30 -05:00
tslint.json build: update lint path for @angular/build-tooling rules (#49266) 2023-02-28 11:56:28 -08:00
WORKSPACE build: update io_bazel_rules_sass digest to 63d77ff (#51243) 2023-09-15 09:04:09 +02:00
yarn.bzl build: update yarn (#50732) 2023-06-16 10:51:09 +02:00
yarn.lock build: update dependency conventional-changelog to v5 (#51606) 2023-09-15 09:07:04 +02:00
yarn.lock.readme.md build: clean up references to old master branch (#45856) 2022-05-04 16:23:33 -07:00

Angular - The modern web developer's platform

angular-logo
Angular is a development platform for building mobile and desktop web applications
using TypeScript/JavaScript and other languages.

www.angular.io

Contributing Guidelines · Submit an Issue · Blog

CI status   Angular on npm   Discord conversation

InsightsSnapshot


Documentation

Get started with Angular, learn the fundamentals and explore advanced topics on our documentation website.

Advanced

Development Setup

Prerequisites

Setting Up a Project

Install the Angular CLI globally:

npm install -g @angular/cli

Create workspace:

ng new [PROJECT NAME]

Run the application:

cd [PROJECT NAME]
ng serve

Angular is cross-platform, fast, scalable, has incredible tooling, and is loved by millions.

Quickstart

Get started in 5 minutes.

Ecosystem

angular ecosystem logos

Changelog

Learn about the latest improvements.

Upgrading

Check out our upgrade guide to find out the best way to upgrade your project.

Contributing

Contributing Guidelines

Read through our contributing guidelines to learn about our submission process, coding rules, and more.

Want to Help?

Want to report a bug, contribute some code, or improve the documentation? Excellent! Read up on our guidelines for contributing and then check out one of our issues labeled as help wanted or good first issue.

Code of Conduct

Help us keep Angular open and inclusive. Please read and follow our Code of Conduct.

Community

Join the conversation and help the community.

Love Angular badge

Love Angular? Give our repo a star ⬆️.