Learn Angular, Angular Material, RxJS, and Signal fundamentals with LocalCast Weather using the Kanban method.
Discover stage management with NgRx and SignalStore.
View live demo: https://local-weather-app-duluca.vercel.app
See Changes section for important or breaking changes made to the project.
Chapter specific examples within
projectshave been renamed, from achformat tostage. e.g.projects/ch2would now be located underprojects/stage2.
LocalCast Weather has been developed to support my book Angular for Enterprise Applications. You can get the book at any major bookstore or find the links at https://AngularForEnterprise.com.
Watch the talk on Architecture for Scalable Angular Apps on Pluralsight.
Check out the slides for Architecture for Scalable Angular Apps free at Slides.com.
Check out LemonMart, an Angular Grocery Store LOB App implemented with a Router-first architecture with common recipes and patterns at https://github.com/duluca/lemon-mart. You can also use LemonMart as a template project to start your own app.
Build, debug and publish Docker images with npm Scripts for Docker and achieve Blue-Green deployments on AWS Fargate with npm Scripts for AWS.
npm run build:prodis used to build a production-optimized version of the app.npm run docker:debugto run tests and build a containerized version of the app.
This app was developed to demonstrate Angular fundamentals, unit testing, and different techniques for building Angular apps using reactive patterns. The app is a good blueprint if you intend to build a largely single-screen app experience. Questions? Consider creating an issue on this repo and buying my book at https://AngularForEnterprise.com.
- Do NOT install
@angular/cliortypescriptglobally to avoid version mismatch issues across multiple projects.- Note: When creating new projects in the future, execute
npx @angular/cli new app-name --routingto create a new Angular app with basic routing wired. - If you have trouble with this command, try
npx -p @angular/cli new app-name --routing
- Note: When creating new projects in the future, execute
- To run
ngcommands from within the project directory, preprendnpxto commands, likenpx ng build. - To continue using
ngwithout having to prependnpx, configure shell autofallback as described here: https://www.npmjs.com/package/npx#shell-auto-fallback.
- Fork and clone this repo.
- Rename the repo on GitHub to match the name of your project.
- Search and replace references to
lemon-martwith your project name and git repo. - Remove
manager,pos, andinventoryfolders and references to them fromapp-routing.module.ts. - To fit your needs, you may modify
profile.component.tsandview-user.component.tsunder theuserfolder. - Edit
lemonmart-theme.scssto match your desired color scheme. - Now you may begin implementing your own feature modules.
- Questions? Consider creating an issue on this repo and buying my book at http://AngularForEnterprise.com.
- Run
npm startfor a development web server. - Navigate to
http://localhost:4200/. The app will automatically reload if you change any of the source files. - Run
npm testto execute the unit tests via Karma. - Run
npm run e2eto execute the end-to-end tests via Cypress.
- Run
ng generate component component-nameto generate a new component. You can also useng generate directive|pipe|service|class|guard|interface|enum|module.
To get more help on the Angular CLI, use
ng helpor go check out the Angular CLI README.
See the example project here https://github.com/duluca/lemon-mart-server
Changes are inevitable to keep the project up-to-date with libraries, tools, patterns and practices. Below are some notable changes that differ from the 1st, 2nd, and 3rd edition of my book.
- Moved to control flow syntax
- Implemented a nearly observable and subscribe-free version using SignalStore in
projects/signal-store
- Renamed
projectsfromch2format tostage2, so they make sense in the 3rd edition. - Replaced tslint with eslint
- Replaced protractor with cypress for e2e, added tests
- Moved to Standalone configuration
- Plan to add @ngrx/component-store example
- Updated
dev-norms.md - Introduced
ngx-mockto supplementangular-unit-test-helperfor mocking components - Replaced
@angular/flex-layoutwith@ngbracket/ngx-layout - Removed
jsbeautifyandimport-sortin prep for migration to eslint - Disabled code coverage in prep for migration to Jest
- Updated
styleandlintscripts - Updated
config.ymlfor CircleCI updates
- Enabled bundle budgets
- Introduction
developmentconfiguration - Made
productionconfiguration the default one - Added
npm run watchcommand - Strict settings on by default
Auguryextension is deprecated. Get to useAngular DevToolsinstead: https://angular.io/guide/devtools.
If you already have a master branch locally, then execute the following commands:
git branch -m master main
git fetch origin
git branch -u origin/main main
git remote set-head origin -a
nowpackage has been replaced withvercel.- CircleCI variable renamed from
$NOW_TOKENto$VERCEL_TOKEN. npm run now:publishrenamed tonpm run vercel:publish.nowv1 configuration with docker deployment is removed.
Sadly Waffle.io no longer exists. I recommend using GitHub Projects as a free replacement.
Unfortunately, Zeit Now no longer allows the publication of arbitrary Dockerfile images. Using Zeit v2 you can publish the output of your dist folder and still be able to host your application for free.
A replacement for publishing arbitrary Docker images would be a new service called Google Cloud Run. A sample command would look like gcloud beta run deploy --image localcast-weather.
As of January 2024, Cloud Run has deprecated private container repositories, which breaks its integration with the docker command. This seemingly subtle change moves Cloud Run from an easy-to-use to a complicated-cloud-service category. For this reason, it has been removed from the book.