Deliver web apps with confidence 🚀
Find a file
Pawel Kozlowski 20008a6b56 refactor(core): rework runtime implementation to simplify and fix issues (#54103)
This commit changes the approach to the reactive node representing query
results: instead of creating a custom node type we can use a computed -
the main change to get there is representing dirty change notification as
a signal (a counter updated every time a query changes its dirty status).

This change is dictated by simplification (we can avoid creation of a custom
signal type) as well as fixes to the multiple issues not covered by the
initial implementation:
- assuring referential stability of results (ex.: the same array instance
  returned from child queries until results change);
- per-view results collection to avoid a situation where accessing query
  results during view creation would return partial / inconsistent results;
- proper refresh of query results for both live and non-connected consumers.

All the above cases are covered by the additional tests in this commit.

PR Close #54103
2024-02-06 15:04:36 +00:00
.circleci ci: migrate snapshot publishing from CircleCI to GHA (#51957) 2023-10-05 10:53:22 -07:00
.devcontainer build: upgrade node version for .devcontainer example file (#53157) 2023-11-27 15:49:35 +01:00
.github build: update actions/checkout action to v4 (#54183) 2024-02-01 16:02:47 +00:00
.husky build: remove unnecessary husky gitignore file (#42870) 2021-07-19 17:31:55 -07:00
.ng-dev refactor: migrate docs, examples, private, service worker and upgrade to prettier formatting (#54163) 2024-01-30 20:08:40 +00:00
.vscode docs: minor update to modify the Bazel extension url (#51925) 2023-09-27 09:21:33 -07:00
.yarn build: update yarn (#50732) 2023-06-16 10:51:09 +02:00
adev docs: fix typo in inject-based DI tutorial (#54245) 2024-02-05 15:06:11 +00:00
aio docs: add Jason Warner to GDE resources (#54237) 2024-02-05 16:40:57 +00:00
devtools refactor(devtools): Add hydration informations (#53910) 2024-01-30 20:03:14 +00:00
docs docs: clarify Node.js version (#53581) 2023-12-18 15:33:40 +00:00
goldens refactor(core): rework runtime implementation to simplify and fix issues (#54103) 2024-02-06 15:04:36 +00:00
integration test: verify output() in signals integration test (#54217) 2024-02-05 15:08:35 +00:00
modules refactor: standardize doctype declaration to <!DOCTYPE html> (#51052) 2024-02-01 19:29:46 +00:00
packages refactor(core): rework runtime implementation to simplify and fix issues (#54103) 2024-02-06 15:04:36 +00:00
scripts refactor: migrate scripts to prettier formatting (#53976) 2024-01-19 10:22:06 +01:00
third_party build: create NodeJS ESM loader for supporting Bazel setup (#48521) 2022-12-19 19:50:40 +00:00
tools docs: Corrected link for defer related blocks (#52704) 2024-01-26 20:38:36 +00:00
.bazelignore test: add integration test for signal inputs in CLI (#53808) 2024-01-10 12:21:05 +00: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
.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 refactor(docs-infra): refactor adev to build using architect (#53497) 2023-12-11 19:21:07 +00:00
.gitmessage build: clean up references to old master branch (#45856) 2022-05-04 16:23:33 -07:00
.mailmap
.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 ci: Add framework team to adev approvers (#54082) 2024-02-01 17:44:59 +00: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 refactor(docs-infra): refactor adev to build using architect (#53497) 2023-12-11 19:21:07 +00:00
CHANGELOG.md release: cut the v17.2.0-next.1 release 2024-01-31 11:29:36 -08: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 refactor(docs-infra): migrate to using docs- prefix for class names rather than adev- for shared pieces (#54188) 2024-01-31 21:49:23 +00:00
packages.bzl refactor(docs-infra): build adev application using local generated assets (#53511) 2023-12-20 14:49:31 -08:00
README.md docs: add documentation and script for local docs dev environment (#54038) 2024-01-25 18:02:27 +00: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: configure tslint to ban performance.mark usages (#52505) 2023-11-03 07:43:36 -07:00
WORKSPACE build: update io_bazel_rules_sass digest to d970cb5 (#52388) 2024-01-31 16:45:07 +00:00
yarn.bzl build: update yarn (#50732) 2023-06-16 10:51:09 +02:00
yarn.lock refactor(docs-infra): migrate to using docs- prefix for class names rather than adev- for shared pieces (#54188) 2024-01-31 21:49:23 +00: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.

angular.dev

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

Local Development

To contribute to Angular docs, you can setup a local environment with the following commands:

# Clone Angular repo
git clone https://github.com/angular/angular.git

# Navigate to project directory
cd angular

# Install dependencies
yarn

# Build and run local dev server
# Note: Initial build will take some time
yarn docs

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 ⬆️.