Part of the curated FullStacksDev Angular and Firebase tech stack. For solo devs and very small teams.

An opinionated full-stack starting point for building a web app, using Angular and Firebase. Aiming to be lean and useful enough so you can hit the ground running and focus on stuff that matters. With enough room for you to extend as you need.

You are free to use and customize this template as you want — build a prototype, an internal tool, a side project, or the next big thing.

This template gives you an empty app skeleton, working end-to-end, with the following included:

• Simple folder-based monorepo with completely separate frontend (app) and backend (firebase) folders, with a VS Code workspace config to work on both folders at the same time.
• A place for shared common code (especially TypeScript types) between frontend and backend (firebase/common).
• Modern Angular features configured and used throughout (inject function, signals, signal inputs, signal outputs, router input bindings, control flow, etc.)
• Full Firebase local development and testing using the Firebase Emulator Suite (with local persistence of emulator data).
• Firebase Hosting, Auth, Firestore, Realtime Database, Cloud Functions and Cloud Storage all set up and ready to use.
• Firebase Hosting configured with appropriate caching rules.
• Basic progressive web app (PWA) set up (manifest, service worker, icons, etc) with in-app update notification.
• Static prerendered pages set up, configured to work properly with Firebase Hosting and the PWA configuration.
• State management using NgRx Signals.
• Global auth store and auth guard.
• Login flow using Firebase Auth's Email Link.
• Angular Material and Tailwind CSS, with styling overrides to make them work well together.
• Helpers to inject Firebase services into Angular components, services, etc.
• RxFire used for Observable wrappers for Firebase access in the frontend.
• Frontend logging using consola.
• VS Code, ESLint, Prettier, etc. all set up for a consistent and clean development experience.
• Continuous integration (CI) set up with GitHub Actions (for linting, tests and builds).
• Deploy script to deploy to a "live" Firebase project (which you set up).
• Basic frontend tests, using Jasmine and ng-mocks.
• Firebase security rules test suites using the Firebase Emulator Suite, using Vitest.

For more details see the Architecture and design decisions doc.

• Node.js v20.x
• TypeScript v5.5
• Angular v18.1
• Angular Material v18.1
• Tailwind CSS v3.4
• NgRx Signals v18.0
• RxFire
• Firebase
  • Hosting
  • Authentication
  • Firestore
  • Realtime Database
  • Cloud Functions
  • Cloud Storage

• Git for version control.
• GitHub for hosting the code and running the CI pipeline.
• VS Code as the main editor.
• pnpm as the package manager and script runner.
• Angular CLI
• Firebase CLI
• Firebase Emulator Suite for local Firebase services.
• ESLint for linting.
• Prettier for code formatting.
• Jasmine for Angular unit testing.
• ng-mocks for Angular testing and mocking helpers.
• Vitest for Firebase testing.

Full instructions on how to use this template are outlined below.

What you need locally before you start:

• Node.js
  • It's recommended to use nvm to manage Node.js versions locally. You can then run nvm use in the root of the repo to use the correct Node.js version (picked up from the .nvmrc file).
  • If installing manually, see the version in the .nvmrc file for the correct version to install.
• pnpm
  • You can install this globally with npm install -g pnpm.
• Git
  • You can also use the GitHub Desktop app (or similar tool) if you prefer.
• VS Code
  • You're welcome to use a different editor, but the workspace settings and integrations are set up for VS Code, and work well out of the box.
• Angular CLI
  • You can install this globally with npm install -g @angular/cli.
  • If you want, you can also set pnpm as the default package manager for Angular CLI by running ng config -g cli.packageManager pnpm (not necessary for this project, but useful for other projects).
• Firebase CLI
  • You can install this globally with npm install -g firebase-tools.
  • You'll also need to log in using firebase login.
• Java JDK version 11 or higher
  • To run the Firebase Emulator Suite locally.

1. Create a new GitHub repo from the base template.
   • See the GitHub instructions on how to create a new repo from a template (either via the GitHub UI or the GitHub CLI).
   • We recommend not selecting "Include all branches" option when creating the new repo.
2. Git clone your new repo locally.
   • You can find instructions for this in the GitHub UI after creating the repo.
   • You can also use the GitHub Desktop app (or similar tool) if you prefer.
3. Open a terminal (we recommend iTerm if on macOS) and open the following 3 panes or tabs:
   1. One for the root of the project — cd into the root of the repo.
   2. One for the app folder — cd into the app folder within the repo.
   3. One for the firebase folder — cd into the firebase folder within the repo.
4. Run pnpm install in both the app and firebase folders (in the separate terminal tabs)
5. Run ./edit in the root to open VS Code with the workspace.
   • This will open the workspace with the app and firebase folders as separate groups in the explorer.
   • The workspace settings come with some extension recommendations. When you first open the workspace you may be alerted to this and given the option to install them (the alert only shows if you don't already have them installed). It's highly recommended to install these extensions to get the best development experience.
6. Update the window.title in the project.code-workspace file.
   • You can open this file to edit by opening the VS Code command palette and searching for (and selecting) "Preferences: Open Workspace Settings (JSON)".
7. Update the app name in a couple of places:
   • app/src/manifest.webmanifest — update the name and short_name fields.
   • app/src/index.html — update the <title> tag.
8. Run pnpm dev in both the app and firebase folders (in the separate terminal tabs).
   • This will start the separate local development servers for the frontend and backend, including the Firebase Emulator Suite.
9. After the dev server processes have finished starting up, open a browser tab to http://localhost:4200 and check that the app is running.
   • We highly recommend always opening the console / dev tools in the browser to check for any errors or warnings (and to view log messages in dev mode).
10. Customize the HomePageComponent to add some project specific text and test that it all looks and works okay locally.
11. Run pnpm test in both the app and firebase folders to check that all existing tests pass.
    • Note: to exit out of the dev processes (from the previous step) you can press Ctrl+C in the terminal.
    • You should notice that the HomePageComponent test fails because you've changed the text. Fix this test to have the updated text and watch as the test suite goes green.
12. Run pnpm build in the app folder to test the production build.
    • Note: this is not necessary to do a deploy, but it's useful to check that the production build works as expected.
13. Edit or delete the root README.md and ARCHITECTURE.md files as you see fit.
    • You're welcome to keep these in your project and adapt them to your needs. Or feel free to delete them.
    • Because VS Code Workspaces don't support adding single files, you can open the files at the root of the repo (like README.md, ARCHITECTURE.md edit and deploy) by running code {filename} in the terminal (in the root folder). This will open the file in the current VS Code window.
14. Rename the LICENSE file to TEMPLATE_LICENSE — you will need to keep this in as everything that comes with the base template is under this license and the original copyright notice must be kept (as per the terms of the MIT license).
    • This does not mean you have to open source your app though — anything you add or substantially change can be licensed as you see fit.
    • Note: this does not constituent legal advice, and you should seek proper advice on how to license your own code.
15. Set up your live Firebase project and add the configuration to the app:
    1. See the next section for instructions on how to set up your "live" Firebase project, and then come back here.
    2. Take the newly created "PWA" config from the step above and update the firebaseConfig object in the environment.live.ts file.
    3. Update the project ID in .firebaserc to match the ID of your live Firebase project.
16. Commit your changes to a branch in your local Git repository and push to GitHub, then open a pull request (PR) from your branch (on GitHub).
    • It's good to get in the habit of pushing changes up to GitHub, preferably in a separate branch first, as you work on your app.
    • When you make (or update) a pull request (PR) on GitHub, or merge to the main branch, the CI pipeline will run the linting, tests and build processes to check that everything is okay. It's good to wait until this is green before you run the deploy locally.
17. Run ./deploy in the root to build and deploy the app and Firebase bits to the live Firebase project.
    • This script will prompt you for confirmation before running anything.
    • It will fail if you haven't already logged into to Firebase using firebase login locally.
    • The first time you run this, Firebase will likely ask you to enable more permissions on the project. Go ahead and do this when prompted.
18. Open the link to the live site (from the end of the deploy output) and check that it all works as expected.
19. Celebrate! 🎉
    • You've set up a new app from the base template and deployed it to a live Firebase project.

1. Go to the Firebase Console.
2. Click "Add project" and follow the steps to create a new project.
   • Tip: call your project "{project name} LIVE" to make it stand out in the list of projects.
   • Don't enable Google Analytics.
3. Once the project is created, let's configure some settings and services…
4. Click the cog icon next to "Project Overview" at the top of the left-hand sidebar and select "Project settings". Then set the "Environment type" to "Production" as this will be your live production Firebase environment.
5. To use Firebase Functions you need to be on a paid plan (as Functions are not supported on the "no-cost" / free usage tier). Use the "Upgrade" button at the bottom of the left-hand sidebar (this will need a billing account to be set up and will walk you through setting one up if needed).
   • Note: the base template is already set up to use and deploy functions but does not come with any actual functions out of the box, so it can be used on the "no cost" / free usage tier if needed, but only after some modifications — see the relevant "how-to" guide below for removing services like functions etc.
   • You'll be able to set a budget alert as part of the upgrade process. Set this to an amount you're comfortable with.
     • IMPORTANT: Firebase won't actually stop charging you if you go over the budget amount, so keep a very close eye on usage and make sure you understand your usage patterns (and the costs associated with them).
6. Click "Authentication" (under "Build") in the left-hand menu and click the button to set up Authentication.
   • Enable the "Email/Password" sign-in method, and make sure to select the "Email link (passwordless sign-in)" option as part of this set-up.
7. Click "Firestore" (under "Build") in the left-hand menu and click the button to create a Firestore database.
   • Keep the default database ID as suggested.
   • Select the physical location for the database.
     • IMPORTANT: this location cannot be changed later, and will be used by other Firebase services.
   • Start in "production mode".
8. Click "Realtime Database" (under "Build") in the left-hand menu and click the button to create a Realtime Database.
   • Select the physical location for the database. Note that this may need to be different to the Firestore database location as you have fewer options here.
   • Start in "locked mode".
9. Click "Storage" (under "Build") in the left-hand menu and click the button to set it up.
   • Start in "production mode".
   • Note: the location is pre-selected to the one you specified for the Firestore database and can't be changed.
10. Go back to the "Project settings" and register a web app entry and copy the necessary config.
    • In the "Your apps" section (towards the bottom of the main page of the project settings) click the icon representing web app ("</>") and give the app a name, like "PWA".
    • Select the "Also set up Firebase Hosting for this app" checkbox.
    • Copy the firebaseConfig object shown in the second step — you'll need this to continue setting up the app.
    • You can ignore all the other set up instructions (as this is already set up for you in the base template) and finish the set-up.

• The Angular app is in the app folder.
• All static prerendered pages are in the app/src/app/website folder.
• You can start adding your app specific features in app/src/app/* folders and hooking up routing.
• Shared code just for the frontend app is in the app/src/app/shared folder.
• The Firebase config etc. is all in the firebase folder.
• Firebase backend functions code go in the firebase/functions folder.
• Shared common code (accessible by both the frontend app and Firebase functions code) is in the firebase/common folder
  • The app can use anything exported here by importing from @common.
  • The Firebase functions code can use relative imports directly to this folder.
• All Firebase security rules (for Firestore, Realtime Database and Storage) are managed in their relevant files in the firebase folder, and are deployed with the app to the live Firebase project.
  • Note that these are locked down by default — you'll need to update them as you start interacting with Firestore, Realtime Database and Storage in your app.
  • If you only plan to use these services from the backend functions then you can keep the rules locked down, as the Firebase Admin SDK has full access (i.e. bypasses all security rules).
• You can configure various aspects of Firebase (like a custom domain name, emails, etc.) in the Firebase Console. We provide some basic "how-to" guides below to help with this.

./edit

You'll need to run this separately in both the app and firebase folders:

pnpm dev

Note: the dev process for the firebase folder will also run the Firebase Emulator Suite for you.

You'll need to run this separately in both the app and firebase folders:

pnpm lint

You'll need to run this separately in both the app and firebase folders:

pnpm test

If you want to test the production build locally. Run this in the app folder:

pnpm build

This deploys the Angular app and Firebase bits to the "live" Firebase project. Run this in the root folder:

./deploy

For apps built on this base template there are two things you need to do to keep updated to the latest dependencies and base template:

1. [Whenever you want] Update the dependencies in the app and firebase folders.
2. [When there's a new base template release] Perform specific tasks to match any new or updated base template bits, as specified in release notes, and at your discretion (depending on how far you've deviated from the base template, and what is relevant to your app).

You can update some or all of the dependencies in the app and firebase folders using the Angular CLI and pnpm (our chosen package manager):

For the app folder:

1. First run pnpm ng update and follow the instructions.
   • This will update the Angular specific dependencies (and any other dependencies that support Angular Schematics for updates).
   • You can choose to skip this step, especially if there is a major version of Angular with breaking changes (in which case you could choose to wait until the base template has been updated first). If you do skip this step, make sure you don't inadvertently update the version of any Angular etc. packages in the next step.
2. Then run pnpm update --interactive --latest and follow the instructions.
   • You can select the packages you want to update.

For the firebase folder:

1. Run pnpm update --interactive --latest and follow the instructions.
   • You can select the packages you want to update.

Make sure to do all this in a branch, test locally and push to GitHub, then open a PR to trigger the continuous integration pipeline (which runs the linter, tests, etc.) and wait until it's green. You'll also want to then do a deploy to your live Firebase project to make sure everything works as expected.

Whenever we make a new release of the base template we will provide detailed release notes with specific instructions on what to do to update your app. These will contain specific code changes you can make (some may be optional), and it will all depend on how much you have deviated from the base template, and what is relevant to your app.

Go to the releases page to find the release notes for the version(s) you want to update to.

We document the architecture and design decisions in a separate doc.

Feel free to deviate from these as you wish. The base template is designed to be fairly flexible so you can adapt it to your needs.

Here we document some how-to guides to help you get started with this base template.

Say you want to add a new static prerendered page to the website part of your app, e.g. a "Contact us" page (served at /contact). Here's how you can do it:

1. Generate a new component in the app/src/app/website folder:
   • In the app folder, run: pnpm ng generate component website/feature/contact-page
2. Add the new component to the website routes in the app/src/app/website/website.routes.ts file.
   • Follow the example of the 'about' route. So, add: { path: 'contact', component: ContactPageComponent }, in the children array.
3. Add an entry in the app/prerendered-routes.txt file.
   • Add a new line with /contact on it.
4. (Optionally) Add a nav entry in the app/src/app/website/website-shell.component.ts file.
5. Check everything works locally by running the dev servers and inspecting the app locally.
6. Run pnpm build in the top-level app folder to test the production build.
   • Within the top-level app folder, you can inspect the dist/app/browser folder to check the prerendered HTML files.
7. Add an entry in the firebase/firebase.json file (under the hosting.rewrites key) to serve the relevant prerendered HTML file for this new path.
   • Follow the example for the /about path.
   • Important: make sure this new entry comes before the ** catch-all entry.
8. Add an exclusion for this new path in the app/ngsw-config.json file (under the navigationUrls key).
   • So, add: "!/contact" to the end of the array.
9. Add content to this new page as you see fit.
10. Fix the tests and make sure everything works as expected.
11. Commit your changes and push to GitHub, opening a PR so the CI pipeline can run.
12. When the CI is green, deploy the app to your live Firebase project.
    • By running the ./deploy script in the root folder, locally.

You'll likely have a main feature section of your app which will be the dynamic user-specific part of the app (together with other dynamic sections like admin, account, etc.)

Say your main feature is a "dashboard", here's how you can add this to the app (as a fully dynamic and lazily-loaded feature):

1. Create a new feature folder: app/src/app/dashboard.
   • Within this folder you'll want to organize things within data, feature, ui and util subfolders (see the architecture doc for details).
2. Create a routes file: app/src/app/dashboard/dashboard.routes.ts.
   • This file will define the routes for the feature as you would in any Angular app.
3. Register the parent path as a route in the app/src/app/app.routes.ts file.
   • You can follow the example of the website routes, setting your path to /dashboard (or whatever you prefer).
   • Note the use of import('./dashboard/dashboard.routes') here — this tells Angular to perform the lazy loading of the feature based on its routes.
4. You'll likely want a shell component for the feature, which all child routes will be rendered within.
   • Run pnpm ng generate component dashboard/dashboard-shell to generate this.
   • And register this as the component for the parent route in the dashboard.routes.ts file, with all child routes defined within.
   • This component will be the parent component for the feature, and will likely contain the main layout (with shared nav, etc.) It must have a <router-outlet /> in it to render the child routes.
5. You'll likely want to lock down everything within this feature to authenticated users only.
   • You can use the authGuard provided by the base template, by adding canMatch: [authGuard('authed')] to the parent route (the one where you specified the dashboard shell component).
   • You could instead choose to only secure particular child routes, by adding the canMatch property to those routes instead, leaving others open.
6. You'll likely want to add a nav entry for this feature on your website pages, so users can navigate to it.
   • Add this in app/src/app/website/website-shell.component.ts.
7. Your feature is ready for development.

The base template comes with a basic PWA set-up, including a manifest file, service worker, etc. Here's how you can configure this for your app:

• Configure the app name, colors, icons, scope, start URL, etc. in: app/src/manifest.webmanifest.
  • This follows the regular PWA manifest spec.
  • Also update the theme-color meta tag in the index.html file to match.
• Update the icons in the app/src/assets/icons folder.
• Configure the service worker in: app/ngsw-config.json.
  • This is the Angular service worker config file (docs).
  • Note that we provide a sensible set-up that works well with the combination of static prerendered pages and dynamic features in the app, so you may not need to change this (and should be careful when doing so).
• Configure the in-app update notification in: app/src/app/app.component.ts.

You may not need the PWA bits in your app. Here's how you can remove them completely:

1. Delete the app/src/manifest.webmanifest file.
2. Remove the mentions of this manifest.webmanifest file in the app/angular.json file.
3. Remove the manifest link in the index.html file.
4. Delete any icons you don't need in the app/src/assets/icons folder.
5. Delete the app/ngsw-config.json file.
6. Remove the "serviceWorker": "ngsw-config.json" bit in the app/angular.json file.
7. Remove the service worker registration in the app/src/app/app.config.ts file.
8. Update any tests that also do the service worker registration.
9. Remove the in-app update notification code in the app/src/app/app.component.ts file.
10. Remove the @angular/service-worker dependency from the app/package.json file.
    • You'll need to run pnpm install in the top-level app folder to remove this dependency from your local node_modules folder and to update the pnpm-lock.yaml file.

You may not need all the Firebase services in your app, especially Firebase Functions which requires a paid plan.

Here's how to remove Firebase Functions from your app:

1. If you want to stay fully within the "no-cost" (aka free) tier of Firebase, make sure you don't upgrade the project in the Firebase Console (for the live project).
2. Update firebase/firebase.json:
   • Remove the whole functions top level config.
   • Remove the entries for the functions, pubsub and eventarc emulators.
3. It's easier to just keep the firebase/functions and firebase/common folders as they are — they won't be used or deployed.

Here's how to remove a service like Firebase Storage from your app (similar steps are applicable to Firestore and Realtime Database):

1. Make sure you don't enable the Storage service in the Firebase Console (when setting up your live project).
2. Update firebase/firebase.json:
   • Remove the storage top level key.
   • Remove the entry for the storage emulator.
3. Delete the security rules file: firebase/storage.rules.
4. Delete the corresponding security rules test suite file: firebase/test/storage/storage-rules.spec.ts.
5. Make sure you don't use the injectStorage helper function in the frontend app.

You can set up a custom domain for your Firebase app in the Firebase Console.

To do this, follow the latest docs from Firebase. As of writing, these are the high level steps we're aware of:

1. Custom domain set-up in the Hosting section
2. Custom domain set-up for the email sender in Authentication
3. Updated action link for the email templates in Authentication
4. Updated “authorized domains” in Authentication
5. Updated config in environment.live.ts in the app to reflect the new auth domain

Some email templates (e.g. for Authentication) are customizable in the Firebase Console.

It's important that the base template is as lean and broadly useful as possible, whilst maintaining the opinionated approach to the tech stack, architecture and patterns that we are developing as part of the curated tech stacks approach in FullStacksDev.

For this reason, we carefully consider what goes into the base template and err on the side of caution. New capabilities are only added to the base template when they are proven to be broadly useful and fit within the tech stack, by first applying them to real-world projects and the example apps.

If you want to continue learning more about the FullStacksDev Angular and Firebase tech stack you can check out the premium example apps built using this template (requires a premium upgrade):

• Simple example app
• Patterns example app (coming soon)

These apps showcase the capabilities of the tech stack and give you an opinionated, pragmatic and in-depth learning experience. Each come with comprehensive documentation and learning content covering patterns, architecture decisions, design decisions, data models, tech stack capabilities, learnings and more.

You can read more about the purpose and specs of the example apps.

This template is licensed under the MIT License — see the LICENSE file for details.