From e4b77f4863172b916dc528ec500db5fdac4dc1b8 Mon Sep 17 00:00:00 2001 From: Bruno Germano Date: Thu, 5 Nov 2026 19:38:59 -0300 Subject: [PATCH 1/6] docs(templates): migrate the framework boilerplate guides to the current guide pattern Refs MM-16246 --- .../templates/angular-boilerplate.mdx | 131 ++++++------ .../docusaurus-javascript-boilerplate.mdx | 119 +++++------ .../docusaurus-typescript-boilerplate.mdx | 119 +++++------ .../templates/gatsby-boilerplate.mdx | 114 +++++------ .../marketplace/templates/htmx-minimal.mdx | 115 +++++------ .../templates/hugo-boilerplate.mdx | 116 +++++------ .../templates/jekyll-boilerplate.mdx | 121 +++++------- .../templates/nextjs-static-boilerplate.mdx | 186 +++++++++--------- .../templates/nuxt-static-boilerplate.mdx | 115 +++++------ .../preact-javascript-boilerplate.mdx | 116 +++++------ .../preact-typescript-boilerplate.mdx | 116 +++++------ .../marketplace/templates/qwik-minimal.mdx | 115 +++++------ .../templates/stencil-boilerplate.mdx | 116 +++++------ .../templates/vite-boilerplate.mdx | 117 ++++++----- .../vitepress-javascript-boilerplate.mdx | 117 +++++------ .../vitepress-typescript-boilerplate.mdx | 117 +++++------ .../templates/vuepress-boilerplate.mdx | 116 +++++------ .../templates/angular-boilerplate.mdx | 128 ++++++------ .../docusaurus-javascript-boilerplate.mdx | 117 +++++------ .../docusaurus-typescript-boilerplate.mdx | 117 +++++------ .../templates/gatsby-boilerplate.mdx | 113 +++++------ .../marketplace/templates/htmx-minimal.mdx | 111 +++++------ .../templates/hugo-boilerplate.mdx | 114 +++++------ .../templates/jekyll-boilerplate.mdx | 119 +++++------ .../templates/next-static-boilerplate.mdx | 184 +++++++++-------- .../templates/nuxt-static-boilerplate.mdx | 113 +++++------ .../preact-javascript-boilerplate.mdx | 112 +++++------ .../preact-typescript-boilerplate.mdx | 112 +++++------ .../marketplace/templates/qwik-minimal.mdx | 111 +++++------ .../templates/stencil-boilerplate.mdx | 112 +++++------ .../templates/vite-boilerplate.mdx | 113 +++++------ .../vitepress-javascript-boilerplate.mdx | 113 +++++------ .../vitepress-typescript-boilerplate.mdx | 113 +++++------ .../templates/vuepress-boilerplate.mdx | 112 +++++------ 34 files changed, 1832 insertions(+), 2248 deletions(-) diff --git a/apps/docs/src/content/docs/en/pages/guides/marketplace/templates/angular-boilerplate.mdx b/apps/docs/src/content/docs/en/pages/guides/marketplace/templates/angular-boilerplate.mdx index 952434e941..062ac3c137 100644 --- a/apps/docs/src/content/docs/en/pages/guides/marketplace/templates/angular-boilerplate.mdx +++ b/apps/docs/src/content/docs/en/pages/guides/marketplace/templates/angular-boilerplate.mdx @@ -1,134 +1,117 @@ --- -title: "Deploy Apps with the Angular Boilerplate" +title: Deploy the Angular Boilerplate description: >- - The Angular Boilerplate provides an automation solution to build an Angular - application on Azion. -meta_tags: 'templates, guides, Azion Marketplace' + Deploy an Angular single-page application to Azion from the Angular + Boilerplate template, which creates a GitHub repository, an application, and + a function. +meta_tags: 'templates, guides, Azion Marketplace, Angular, Angular Boilerplate' namespace: docs_guides_angular_boilerplate permalink: /documentation/guides/application-development/frameworks/angular-boilerplate/ --- - import DocSteps from '@aziontech/webkit/doc-steps' import DocStep from '@aziontech/webkit/doc-step' -import DocButton from '~/components/webkit/DocButton.vue'; - -The Azion **Angular Boilerplate** provides an automation solution to build an **Angular Single-Page Application (SPA)** and run it directly on Azion's distributed infrastructure, encapsulating several steps, from repository management to deployment. - -This template uses Angular version `19.2.1`. - ---- +import DocCardGroup from '@aziontech/webkit/doc-card-group' +import DocCard from '@aziontech/webkit/doc-card' -## Requirements +You can deploy an Angular single-page application (SPA) to Azion from the Angular Boilerplate template in Azion Console. To create an application without a template, refer to [Applications quickstart](/en/documentation/platform/applications/quickstart/). -- A [GitHub account](https://github.com/signup) to connect with Azion and create your new repository. - - Every push will be deployed automatically to this repository to keep your project updated. +The template automates the steps from repository management to deployment, and the application runs on Azion's distributed infrastructure. The template uses Angular `19.2.1`. -- This template uses [Functions](/en/documentation/platform/functions/) and it may generate usage-related costs. Check the [pricing page](https://www.azion.com/en/pricing/) for more information. +The deployment creates a GitHub repository for your project, an [application](/en/documentation/platform/applications/) that serves it, a function for custom logic, and a domain to reach it. The template uses [Functions](/en/documentation/platform/functions/), and its usage can generate costs. For more information, refer to [Pricing](/en/documentation/fundamentals/pricing/). --- -## Deploying the template +## Prerequisites -You can obtain and configure your template through the Azion Console. To easily deploy it on Azion, select the button below. - - +- An Azion account. To create one, refer to [Create an account](/en/documentation/fundamentals/creating-account/). +- Access to Azion Console. To sign in, refer to [Access Azion Console](/en/documentation/guides/platform/account-and-billing/how-to-access-azion-console/). +- A [GitHub account](https://github.com/signup). Azion connects to it and creates the project's repository there. --- -## Setting up the template +## Deploy the template -In the configuration form, you must provide the information to configure your Angular application. Fill in the presented fields. +The Angular Boilerplate opens as a configuration form in Azion Console, and an asterisk marks each mandatory field. -Fields identified with an asterisk are mandatory. +To deploy the template: - - - - A pop-up window will open to confirm the installation of the [Azion GitHub App](/en/documentation/guides/application-development/automation/azion-github-app/), a tool that connects your GitHub account with Azion's platform. - - Define your permissions and repository access as desired. - - - + - Select the **Git Scope** to work with. + Go to [Angular Boilerplate](https://console.azion.com/create/angular/angular-boilerplate) in Azion Console. The configuration form opens. - + - - The bucket for storage and the function will use the same name. - - Use a unique and easy-to-remember name. If the name has already been used, the platform returns an error message. + A window opens to confirm the installation of the [Azion GitHub App](/en/documentation/guides/application-development/automation/azion-github-app/), which connects your GitHub account with Azion. In that window, define the app's permissions and repository access. - + + - Select the **Deploy** button to start the deployment process. + Enter a unique name that you can remember. The storage bucket and the function that the template creates take the same name. If the name is already in use, the platform returns an error message. + -During the deployment, you'll be able to follow the process through a window showing the logs. When it's complete, the page shows information about the application and some options to continue your journey. - -:::note -The link to the application allows you to see it on the browser. However, it takes a certain time to propagate and configure the application on Azion's distributed infrastructure. It may be necessary to wait a few minutes for the URL to be activated and for the application page to be effectively displayed in the browser. -::: +A window shows the deployment logs while it runs. When the deployment completes, the page shows the application's details, a browser link to it, and options to continue. The deployment leaves you with: -### Key configurations +- A GitHub repository created from the [Angular Boilerplate sample](https://github.com/aziontech/azion-samples/tree/dev/templates/angular/angular-boilerplate), with its dependencies installed. +- A GitHub Action in that repository for continuous deployment. +- A commit in the repository that records the deployed version and the deployment timestamp, so the deployment history stays traceable. +- An application on Azion Platform, with a domain that serves the Angular project and a function for custom logic. -The script creates a [GitHub repository](https://github.com/aziontech/azion-samples/tree/dev/templates/angular/angular-boilerplate) to manage the source code and then it installs all required dependencies. The template also includes a GitHub Action to enable continuous deployment. +The template builds the project with the [Azion Bundler framework adapter](/en/documentation/devtools/runtime/frameworks/frameworks-compatibility/). -With the integration of the [Azion Bundler framework adapter](/en/documentation/devtools/runtime/frameworks/frameworks-compatibility/), the application undergoes an optimized build process, emphasizing optimal performance and efficiency. +The link can take a few minutes to start serving the application, while its configuration propagates across Azion's distributed infrastructure. If the page does not load, wait a few minutes and open the link again. -Besides that, the script deploys your application on the Azion Web Platform and carries out multiple configurations, including setting up the application and its domain to host your Angular.js project and a function for custom logic. +This video, from Azion's YouTube channel, walks through the deployment of the Angular Boilerplate: -To maintain a transparent and trackable deployment history, the script commits deployment details to the user's GitHub repository, including information related to the version deployed and the timestamp of the deployment. +