Skip to content

Commit

Permalink
[EDU-5544]feat:cosmicjs-new-guides (#1439)
Browse files Browse the repository at this point in the history
* feat:new-cosmicjs-simple-next-blog

* Create cosmicjs-

* feat: new-cosmic-guides

* Update src/content/docs/en/pages/guides/marketplace/templates/cosmic-agency-website.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/guides/marketplace/templates/cosmic-agency-website.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/guides/marketplace/templates/cosmic-agency-website.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/guides/marketplace/templates/cosmic-simple-astro-blog.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/guides/marketplace/templates/cosmic-simple-astro-blog.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/guides/marketplace/templates/cosmic-simple-astro-blog.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/guides/marketplace/templates/cosmic-agency-website.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/guides/marketplace/templates/cosmic-simple-astro-blog.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/guides/marketplace/templates/cosmicjs-simple-next-blog-template.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/guides/marketplace/templates/cosmicjs-simple-next-blog-template.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/guides/marketplace/templates/cosmicjs-simple-next-blog-template.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/guides/marketplace/templates/cosmicjs-simple-next-blog-template.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/guides/marketplace/templates/cosmicjs-simple-next-blog-template.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/main-menu/additional-resources/templates-and-integrations/understand-azion-templates.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/main-menu/additional-resources/templates-and-integrations/understand-azion-templates.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/main-menu/additional-resources/templates-and-integrations/understand-azion-templates.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/main-menu/additional-resources/templates-and-integrations/understand-azion-templates.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/main-menu/additional-resources/templates-and-integrations/understand-azion-templates.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/en/pages/guides/marketplace/templates/cosmic-simple-astro-blog.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/pt-br/pages/guias/marketplace/templates/cosmic-simple-astro-blog.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/pt-br/pages/guias/marketplace/templates/cosmic-simple-next-blog.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/pt-br/pages/guias/marketplace/templates/cosmic-simple-next-blog.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/pt-br/pages/menu-principal/recursos-adicionais/templates-e-integracoes/templates-visao-geral.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/pt-br/pages/menu-principal/recursos-adicionais/templates-e-integracoes/templates-visao-geral.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

* Update src/content/docs/pt-br/pages/menu-principal/recursos-adicionais/templates-e-integracoes/templates-visao-geral.mdx

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>

---------

Co-authored-by: Mariana Bellorín Aguilera <[email protected]>
  • Loading branch information
MarianaReisAlcantara and MarianaAguilera authored Jan 17, 2025
1 parent e141a68 commit 52e1426
Show file tree
Hide file tree
Showing 11 changed files with 644 additions and 0 deletions.
3 changes: 3 additions & 0 deletions src/content/docs/en/pages/guides/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -82,6 +82,9 @@ permalink: /documentation/products/guides/
- [How to deploy and test HTMX on the edge with a template](/en/documentation/products/guides/htmx-boilerplate/)
- [How to deploy edge applications with the Angular Boilerplate](/en/documentation/products/guides/angular-boilerplate/)
- [How to deploy edge applications with the Astro Boilerplate](/en/documentation/products/guides/astro-boilerplate/)
- [How to deploy edge applications with CosmicJS Agency Website](/en/documentation/products/guides/cosmic-agency-website/)
- [How to deploy edge applications with CosmicJS Simple Astro Blog](/en/documentation/products/guides/cosmic-simple-astro-blog/)
- [How to deploy edge applications with CosmicJS Simple Next.js Blog](/en/documentation/products/guides/cosmic-simple-next-blog/)
- [How to deploy edge applications with the Gatsby Boilerplate](/en/documentation/products/guides/gatsby-boilerplate/)
- [How to deploy edge applications with the Hexo Boilerplate](/en/documentation/products/guides/hexo-boilerplate/)
- [How to deploy edge applications with the Next.js Static Boilerplate](/en/documentation/products/guides/nextjs-static-boilerplate/)
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
---
title: How to deploy edge applications with CosmicJS Agency Website
Description: The CosmicJS Agency Website template helps you create a dynamic website using Cosmic's React components and Blocks to showcase your services and portfolio.
meta_tags: 'templates, guides, Azion Marketplace, CosmicJS, Agency, website'
namespace: docs_guides_cosmicjs_agency_website
permalink: /documentation/products/guides/cosmic-agency-website/
---

import Tag from 'primevue/tag';

<Tag severity="info" client:only="vue">
Preview
</Tag>

The Azion **CosmicJS Agency Website** template is specifically designed to help you create a dynamic and visually appealing online presence. Utilizing Cosmic's **React components** and **Blocks**, this template provides a robust framework for building customizable websites that showcase your services and portfolio.

This template uses Next version `14.2.5`.

---

## Requirements

- 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.
- A [Cosmic CMS](https://www.cosmicjs.com/) account.
- A [Stripe](https://stripe.com/en-br) account.
- This template uses [Application Accelerator](/en/documentation/products/build/edge-application/application-accelerator/), [Edge Functions](/en/documentation/products/build/edge-application/edge-functions/), and [Edge Cache](https://www.azion.com/en/documentation/products/build/edge-application/edge-cache/), and it could generate usage-related costs. Check the [pricing page](https://www.azion.com/en/pricing/) for more information.

---

## Deploying the template

You can obtain and configure your template through the Azion Console. To easily deploy it at the edge, click the button below.

<LinkButton
label="Deploy"
link="https://console.azion.com/create/cosmic/cosmic-agency-website"
icon="ai ai-azion"
icon-pos="left"
/>

---

## Setting up the template

In the configuration form, you must provide the information to configure your application. Fill in the presented fields.

Fields identified with an asterisk are mandatory.

1. Connect Azion with your GitHub account.
- A pop-up window will open to confirm the installation of the [Azion GitHub App](https://www.azion.com/en/documentation/products/guides/azion-github-app/), a tool that connects your GitHub account with Azion's platform.
- Define your permissions and repository access as desired.
2. Select the **Git Scope** to work with.
3. Fill in the information to setup the application:
- **Application Name**: define a unique name for your edge application.
- **Cosmic Bucket Slug**: the identifier of the bucket from which the application will fetch content.
- **Cosmic API Read Key**: the access key required to read the bucket.
- **Cosmic API Write Key**: the access key required for writing to the bucket (as this template enables write operations).
- **Stripe Publishable Key**: the public API key used for client-side interactions with Stripe.
- **Stripe Secret Key**: the private API key used for secure server-side transactions with Stripe.

4. Click the **Deploy** button to start the deployment process.

During the deployment, you'll be able to follow the process through a window showing off 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 edge application allows you to see it on the browser. However, it takes a certain time to propagate and configure the application in Azion's edge locations. 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.
:::

---

## Managing the template

Considering that this initial setup may not be optimal for your specific edge application, all settings can be customized any time you need by using Azion's platform.

To manage and edit your edge application's settings, follow these steps:

1. [Access Azion Console](https://console.azion.com).
2. On the upper-left corner, select **Products menu**, the icon with three horizontal lines, > **Edge Application**.
- You'll be redirected to the **Edge Application** page. It lists all the edge applications you've created.
3. Find the edge application related to your template and select it.
- The list is organized alphabetically. You can also use the **search bar** located in the upper-left corner of the list; currently, it filters only by **Application Name**.

After selecting the edge application you'll work on, you'll be directed to a page containing all the settings you can configure.

:::tip
Read the documentation about [managing edge applications](/en/documentation/products/build/edge-application/first-steps/) for more details.
:::

### Adding a custom domain

The edge application created during the deployment has an assigned Azion domain to make it accessible through the browser. The domain has the following format: `xxxxxxxxxx.map.azionedge.net/`. However, you can add a custom domain for users to access your edge application through it.

import LinkButton from 'azion-webkit/linkbutton';

<LinkButton link="/en/documentation/products/guides/configure-a-domain/" label="Go to Configuring a Domain Guide" severity="secondary" />
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
---
title: How to deploy edge applications with CosmicJS Simple Astro Blog
description: The CosmicJS Simple Astro Blog template allows you to create and manage a blog easily, using Astro and Cosmic headless CMS for content management.
meta_tags: 'templates, guides, Azion Marketplace, CosmicJS, Astro, blog'
namespace: docs_guides_cosmicjs_simple_astro_blog
permalink: /documentation/products/guides/cosmic-simple-astro-blog/
---

import Tag from 'primevue/tag';

<Tag severity="info" client:only="vue">
Preview
</Tag>

The Azion **CosmicJS Simple Astro Blog** template is designed to provide a seamless blogging experience using [Astro](https://docs.astro.build/en/concepts/why-astro/) and [Cosmic](https://www.cosmicjs.com/), a headless CMS. It allows you to create a fully functional blog with minimal setup, using the power of Cosmic's headless CMS for content management.

This template uses Astro version `3.0.8`.

---

## Requirements

- 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.
- A [Cosmic CMS](https://www.cosmicjs.com/) account.
- This template uses [Application Accelerator](/en/documentation/products/build/edge-application/application-accelerator/), [Edge Functions](/en/documentation/products/build/edge-application/edge-functions/), and [Edge Cache](https://www.azion.com/en/documentation/products/build/edge-application/edge-cache/), and it could generate usage-related costs. Check the [pricing page](https://www.azion.com/en/pricing/) for more information.

---
## Deploying the template

You can obtain and configure your template through the Azion Console. To easily deploy it at the edge, click the button below.

<LinkButton
label="Deploy"
link="https://console.azion.com/create/cosmic/cosmic-simple-astro-blog"
icon="ai ai-azion"
icon-pos="left"
/>

---

## Setting up the template

In the configuration form, you must provide the information to configure your application. Fill in the presented fields.

Fields identified with an asterisk are mandatory.

1. Connect Azion with your GitHub account.
- A pop-up window will open to confirm the installation of the [Azion GitHub App](https://www.azion.com/en/documentation/products/guides/azion-github-app/), a tool that connects your GitHub account with Azion's platform.
- Define your permissions and repository access as desired.
2. Select the **Git Scope** to work with.
3. Fill in the information to setup the application:
- **Application Name**: define a unique name for your edge application.
- **Cosmic Bucket Slug**: the identifier of the bucket from which the application will fetch content.
- **Cosmic API Read Key**: the access key required to read the bucket.
4. Click the **Deploy** button to start the deployment process.

During the deployment, you'll be able to follow the process through a window showing off the logs. When it's complete, the page shows information about the application and some options to continue your journey.

:::caution[important]
When updating content on the platform, you'll need to redeploy your edge application onto Azion's edge network through [Azion CLI](https://www.azion.com/en/documentation/devtools/cli/deploy).
:::

:::note
The link to the edge application allows you to see it on the browser. However, it takes a certain time to propagate and configure the application in Azion's edge locations. 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.
:::

---

## Managing the template

Considering that this initial setup may not be optimal for your specific edge application, all settings can be customized any time you need by using Azion's platform.

To manage and edit your edge application's settings, follow these steps:

1. [Access Azion Console](https://console.azion.com).
2. On the upper-left corner, select **Products menu**, the icon with three horizontal lines, > **Edge Application**.
- You'll be redirected to the **Edge Application** page. It lists all the edge applications you've created.
3. Find the edge application related to your template and select it.
- The list is organized alphabetically. You can also use the **search bar** located in the upper-left corner of the list; currently, it filters only by **Application Name**.

After selecting the edge application you'll work on, you'll be directed to a page containing all the settings you can configure.

:::tip
Read the documentation about [managing edge applications](/en/documentation/products/build/edge-application/first-steps/) for more details.
:::

### Adding a custom domain

The edge application created during the deployment has an assigned Azion domain to make it accessible through the browser. The domain has the following format: `xxxxxxxxxx.map.azionedge.net/`. However, you can add a custom domain for users to access your edge application through it.

import LinkButton from 'azion-webkit/linkbutton';

<LinkButton link="/en/documentation/products/guides/configure-a-domain/" label="Go to Configuring a Domain Guide" severity="secondary" />
Empty file.
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
---
title: How to deploy edge applications with CosmicJS Simple Next.js Blog
description: The CosmicJS Simple Next.js Blog template allows you to create and manage a blog easily, using Next.js' capabilities for optimal performance and user experience.
meta_tags: 'templates, guides, Azion Marketplace, CosmicJS, Nextjs, blog'
namespace: docs_guides_cosmicjs_simple_next_blog
permalink: /documentation/products/guides/cosmic-simple-next-blog/
---

import Tag from 'primevue/tag';

<Tag severity="info" client:only="vue">
Preview
</Tag>

The Azion CosmicJS Simple Next.js Blog template provides an efficient blogging platform using [Next.js](https://nextjs.org/docs) and [Cosmic](https://www.cosmicjs.com/), a headless CMS. It allows you to create and manage a blog easily, using Next.js's capabilities for optimal performance and user experience.

This template uses Next version `14.2.5`.

---

## Requirements

- 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.
- A [Cosmic CMS](https://www.cosmicjs.com/) account.
- This template uses [Application Accelerator](/en/documentation/products/build/edge-application/application-accelerator/), [Edge Functions](/en/documentation/products/build/edge-application/edge-functions/), and [Edge Cache](https://www.azion.com/en/documentation/products/build/edge-application/edge-cache/), and it could generate usage-related costs. Check the [pricing page](https://www.azion.com/en/pricing/) for more information.

---

## Deploying the template

You can obtain and configure your template through the Azion Console. To easily deploy it at the edge, click the button below.

<LinkButton
label="Deploy"
link="https://console.azion.com/create/cosmic/cosmic-simple-nextjs-blog"
icon="ai ai-azion"
icon-pos="left"
/>

---

## Setting up the template

In the configuration form, you must provide the information to configure your application. Fill in the presented fields.

Fields identified with an asterisk are mandatory.

1. Connect Azion with your GitHub account.
- A pop-up window will open to confirm the installation of the [Azion GitHub App](https://www.azion.com/en/documentation/products/guides/azion-github-app/), a tool that connects your GitHub account with Azion's platform.
- Define your permissions and repository access as desired.
2. Select the **Git Scope** to work with.
3. Fill in the information to setup the application:
- **Application Name**: define a unique name for your edge application.
- **Cosmic Bucket Slug**: the identifier of the bucket from which the application will fetch content.
- **Cosmic API Read Key**: the access key required to read the bucket.
4. Click the **Deploy** button to start the deployment process.

During the deployment, you'll be able to follow the process through a window showing off 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 edge application allows you to see it on the browser. However, it takes a certain time to propagate and configure the application in Azion's edge locations. 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.
:::

---

## Managing the template

Considering that this initial setup may not be optimal for your specific edge application, all settings can be customized any time you need by using Azion's platform.

To manage and edit your edge application's settings, follow these steps:

1. [Access Azion Console](https://console.azion.com).
2. On the upper-left corner, select **Products menu**, the icon with three horizontal lines, > **Edge Application**.
- You'll be redirected to the **Edge Application** page. It lists all the edge applications you've created.
3. Find the edge application related to your template and select it.
- The list is organized alphabetically. You can also use the **search bar** located in the upper-left corner of the list; currently, it filters only by **Application Name**.

After selecting the edge application you'll work on, you'll be directed to a page containing all the settings you can configure.

:::tip
Read the documentation about [managing edge applications](/en/documentation/products/build/edge-application/first-steps/) for more details.
:::

### Adding a custom domain

The edge application created during the deployment has an assigned Azion domain to make it accessible through the browser. The domain has the following format: `xxxxxxxxxx.map.azionedge.net/`. However, you can add a custom domain for users to access your edge application through it.

import LinkButton from 'azion-webkit/linkbutton';

<LinkButton link="/en/documentation/products/guides/configure-a-domain/" label="Go to Configuring a Domain Guide" severity="secondary" />
Original file line number Diff line number Diff line change
Expand Up @@ -161,6 +161,45 @@ This template helps you build an e-commerce application based on the React frame
icon-pos="left"
/>

#### CosmicJS + Agency Website

This template helps you create a dynamic website using Cosmic's React components and Blocks to showcase your services and portfolio.

<LinkButton link="/en/documentation/products/guides/cosmic-agency-website/" label="Go to the CosmicJS + Agency Website guide" severity="secondary" />

<LinkButton
label="Deploy"
link="https://console.azion.com/create/cosmic/cosmic-agency-website"
icon="ai ai-azion"
icon-pos="left"
/>

#### CosmicJS + Simple Astro Blog

This template allows you to create and manage a blog easily, using Astro and Cosmic headless CMS for content management.

<LinkButton link="/en/documentation/products/guides/cosmic-simple-astro-blog/" label="Go to the CosmicJS + Simple Astro Blog guide" severity="secondary" />

<LinkButton
label="Deploy"
link="https://console.azion.com/create/cosmic/cosmic-simple-astro-blog"
icon="ai ai-azion"
icon-pos="left"
/>

#### CosmicJS + Simple Next.js Blog

This template allows you to create and manage a blog easily, using the capabilities of Next.js for optimal performance and user experience.

<LinkButton link="/en//documentation/products/guides/cosmic-simple-next-blog/" label="Go to the CosmicJS + Simple Next.js Blog guide" severity="secondary" />

<LinkButton
label="Deploy"
link="https://console.azion.com/create/cosmic/cosmic-simple-nextjs-blog"
icon="ai ai-azion"
icon-pos="left"
/>

#### DevsCard

This template helps you deploy an online resume using the DevsCard project.
Expand Down
3 changes: 3 additions & 0 deletions src/content/docs/pt-br/pages/guias/guides.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,9 @@ permalink: /documentacao/produtos/guias/
- [Como bloquear requisições de Tor Exit Nodes usando um template](/pt-br/documentacao/produtos/guias/bot-manager-lite-and-tor-block-starter-kit/)
- [Como criar edge applications com o Angular Boilerplate](/pt-br/documentacao/produtos/guias/angular-boilerplate/)
- [Como criar edge applications com o Astro Boilerplate](/pt-br/documentacao/produtos/guias/astro-boilerplate/)
- [Como criar edge applications com o CosmicJS + Agency template](/pt-br/documentacao/produtos/guias/cosmic-agency-website/)
- [Como criar edge applications com o CosmicJS + Simple Astro template](/pt-br/documentacao/produtos/guias/cosmic-simple-astro-blog/)
- [Como criar edge applications com o CosmicJS + Simple Next.js template](/pt-br/documentacao/produtos/guias/cosmic-simple-next-blog/)
- [Como criar edge applications com o Gatsby Boilerplate](/pt-br/documentacao/produtos/guias/gatsby-boilerplate/)
- [Como criar edge applications com o Hexo Boilerplate](/pt-br/documentacao/produtos/guias/hexo-boilerplate/)
- [Como criar edge applications com o Next.js Static Boilerplate](/pt-br/documentacao/produtos/guias/nextjs-static-boilerplate/)
Expand Down
Loading

0 comments on commit 52e1426

Please sign in to comment.