Deploy an Angular site

Angular Open external link is an incredibly popular framework for building reactive and powerful front-end applications.

In this guide, you will create a new Angular application and deploy it using Cloudflare Pages. You will use the Angular CLI, a batteries-included tool for generating new Angular applications.

​​ Setting up a new project

Use the create-cloudflare Open external link CLI (C3) to set up a new project. C3 will create a new project directory, initiate Angular’s official setup tool, and provide the option to deploy instantly. To use create-cloudflare to create a new Angular project, run the following command:

To use create-cloudflare to create a new Angular project, run the following command:

$ npm create cloudflare@latest my-angular-app -- --framework=angular

create-cloudflare will install dependencies, including the Wrangler CLI and the Cloudflare Pages adapter, and ask you setup questions.

​​ Before you continue

All of the framework guides assume you already have a fundamental understanding of Git Open external link . If you are new to Git, refer to this summarized Git handbook Open external link on how to set up Git on your local machine.

If you clone with SSH, you must generate SSH keys Open external link on each computer you use to push or pull from GitHub.

Refer to the GitHub documentation Open external link and Git documentation Open external link for more information.

​​ Create a GitHub repository

Create a new GitHub repository by visiting repo.new Open external link . After creating a new repository, go to your newly created project directory to prepare and push your local application to GitHub by running the following commands in your terminal:

$ git remote add origin https://github.com/<your-gh-username>/<repository-name>
$ git branch -M main
$ git push -u origin main

​​ Deploy with Cloudflare Pages

​​ Deploy via the create-cloudflare CLI (C3)

If you use create-cloudflare(C3) Open external link to create your new Angular project, C3 will install all dependencies needed for your project and prompt you to deploy your project via the CLI. If you deploy, your site will be live and you will be provided with a deployment URL.

​​ Deploy via the Cloudflare dashboard

1. Log in to the Cloudflare dashboard Open external link and select your account.
2. In Account Home, select Workers & Pages > Create application > Pages > Connect to Git.

You will be asked to authorize access to your GitHub account if you have not already done so. Cloudflare needs this so that it can monitor and deploy your projects from the source. You may narrow access to specific repositories if you prefer; however, you will have to manually update this list within your GitHub settings Open external link when you want to add more repositories to Cloudflare Pages.

Select the new GitHub repository that you created and, in the Set up builds and deployments section, provide the following information:

Optionally, you can customize the Project name field. It defaults to the GitHub repository’s name, but it does not need to match. The Project name value is assigned as your *.pages.dev subdomain.

​​ Angular CLI Configuration

Angular CLI expects to build and manage multiple projects by default.

When you generated a new project, you called it "my-angular-app" which means that Angular CLI created an angular.json file with a "my-angular-app" configuration key under the "projects" block. The CLI does this to prepare your workspace for new projects and configurations to be added at any point in time. It should look similar to this:

// angular.json
{
  // ...
  "projects": {
    "my-angular-app": {
      "projectType": "application",
      // ...
      "architect": {
        "build": {
          "builder": "@angular-devkit/build-angular:browser",
          "options": {
            "outputPath": "dist/my-angular-app",
            "index": "src/index.html",
            // ...
          }
        }
      }
    }
  }
}

You will notice that there is an outputPath option within the projects.my-angular-app.architect.build object. This value tells Angular CLI where to place the “my-angular-app” project’s output files. By default, it is dist/my-angular-app which is reflected in the Build directory setting of the Pages configuration.

You can modify this outputPath value but you must update the Pages settings too.

​​ Finalize Setup

After completing configuration, click the Save and Deploy button.

You will see your first deploy pipeline in progress. Pages installs all dependencies – including Angular CLI – and builds the project as specified.

After deploying your site, you will receive a unique subdomain for your project on *.pages.dev.

Cloudflare Pages will automatically rebuild your project and deploy it on every new pushed commit.

Additionally, you will have access to preview deployments, which repeat the build-and-deploy process for pull requests. With these, you can preview changes to your project with a real URL before deploying them to production.

​​ Learn more

By completing this guide, you have successfully deployed your Angular site to Cloudflare Pages. To get started with other frameworks, refer to the list of Framework guides.