Skip to content

Commit 4a3d4d4

Browse files
[EDU-5544] feat:new-cosmic-readme-files (#213)
* feat:new-cosmic-readme-files * Update templates/nextjs/cosmic-simple-nextjs-blog/README.md Co-authored-by: Mariana Bellorín Aguilera <[email protected]> --------- Co-authored-by: Mariana Bellorín Aguilera <[email protected]>
1 parent 6cf5f67 commit 4a3d4d4

File tree

3 files changed

+53
-131
lines changed

3 files changed

+53
-131
lines changed
Original file line numberDiff line numberDiff line change
@@ -1,54 +1,31 @@
1-
# Simple Astro Blog built with Astro and Cosmic
1+
# CosmicJS Simple Astro Blog
22

3-
To build this app, we’re going to use the following technologies:
3+
The **CosmicJS Simple Astro Blog** template helps you create and manage a blog easily, combining [Astro](https://docs.astro.build/en/concepts/why-astro/)'s performance with [Cosmic](https://www.cosmicjs.com/) headless CMS for content management.
44

5-
- [Astro](https://astro.build/) - A React framework for production that makes it easy to spin up a full-stack application.
6-
- [Cosmic](https://www.cosmicjs.com/) - A Headless CMS enables the independence of the data (content) layer and gives us the ability to quickly manage template content.
7-
- [Tailwind CSS](https://tailwindcss.com/) - A performant utility-first CSS framework that can be composed directly in your markup.
5+
This repository is an example of the new GitHub repository created during the deployment. For a more detailed step-by-step to deploy this template through Azion's platform, check the [How to deploy edge applications with CosmicJS Simple Astro Blog](https://www.azion.com/en/documentation/products/guides/cosmic-simple-astro-blog/) guide.
86

9-
### Links
7+
This template uses Astro version `3.0.8`.
108

11-
- [Install the template](https://www.cosmicjs.com/marketplace/templates/simple-astro-blog)
12-
- [View the live demo](https://simple-astro-blog.vercel.app/)
9+
---
1310

14-
## Screenshots
11+
## Requirements
1512

16-
![Home Page](https://imgix.cosmicjs.com/e0b61790-32db-11ed-8a37-f1952c73e588-astro-cms-screenshot-4.png?w=1200&auto=format)
13+
Before using this template, you need to:
1714

18-
![Blog Page](https://cdn.cosmicjs.com/cbd90ee0-32db-11ed-8a37-f1952c73e588-astro-cms-screenshot-3.png)
15+
- Have a [GitHub account](https://github.com/signup).
16+
- Every push will be deployed automatically to the main branch in this repository to keep your project updated.
17+
- A [Cosmic CMS](https://www.cosmicjs.com/) account.
1918

20-
## Getting started
19+
> **Note**: this template uses [Application Accelerator](https://www.azion.com/en/documentation/products/build/edge-application/application-accelerator/), [Edge Functions](https://www.azion.com/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.
2120
22-
### Environment Variables
21+
Fill in the fields presented on the configuration form and deploy the template. This will create a new edge application with its configurations, which you can edit and manage later. It also creates a repository in your GitHub account, based on the template, allowing you to maintain control over the project.
2322

24-
You'll need to create an .env file in the root of the project. Log in to Cosmic and from Bucket Settings > API Access take the following values:
23+
---
2524

26-
```
27-
//.env
28-
PUBLIC_COSMIC_BUCKET_SLUG=your_cosmic_slug
29-
PUBLIC_COSMIC_READ_KEY=your_cosmic_read_key
30-
```
25+
## Deploy your own
3126

32-
Install the dependencies with
27+
Deploy your own CosmicJS Simple Astro Blog project with Azion.
3328

34-
```
35-
pnpm install
36-
# or
37-
yarn install
38-
# or
39-
npm install
40-
```
29+
[![Deploy Button](https://www.azion.com/button/)](https://console.azion.com/create/cosmic/cosmic-simple-astro-blog "Deploy with Azion")
4130

42-
Then run the development server:
43-
44-
```
45-
pnpm run dev
46-
# or
47-
yarn dev
48-
# or
49-
npm run dev
50-
```
51-
52-
Open [http://localhost:3000](http://localhost:3000/) with your browser to see the result.
53-
54-
You can start editing the page by modifying `src/pages/index.astro`. The page auto-updates as you edit the file.
31+
For a more detailed step-by-step, check the [documentation](https://www.azion.com/en/documentation/products/guides/cosmic-simple-astro-blog/).
+19-59
Original file line numberDiff line numberDiff line change
@@ -1,73 +1,33 @@
1-
# Agency Template, powered by Blocks
1+
# CosmicJS Agency Website
22

3-
![desktop.png](https://imgix.cosmicjs.com/69313380-b156-11ee-9844-f9a09795e2a3-desktop.png)
3+
The **CosmicJS Agency Website** template helps you create a dynamic and visually appealing online presence with customizable websites to showcase your services and portfolio.
44

5-
### UPDATED
5+
This repository is an example of the new GitHub repository created during the deployment. For a more detailed step-by-step to deploy this template through Azion's platform, check the [How to deploy edge applications with CosmicJS Agency Website
6+
](https://www.azion.com/en/documentation/products/guides/cosmic-agency-website/) guide.
67

7-
🛒 Now includes product management and checkout using Stripe.
8+
This template uses Next version `14.2.5`.
89

9-
A website template built using Cosmic's React components, [Blocks](https://blocks.cosmicjs.com). Use this template to get familiar with Blocks and how they can be used to build common content-powered features for your websites and apps, or simply use it as a starting point for your next project. Save development time and learn content modeling best practices.
10+
---
1011

11-
## Links
12+
## Requirements
1213

13-
[Install this template](https://www.cosmicjs.com/marketplace/templates/agency)
14+
Before using this template, you need to:
1415

15-
## Features
16+
- Have a [GitHub account](https://github.com/signup).
17+
- Every push will be deployed automatically to the main branch in this repository to keep your project updated.
18+
- A [Cosmic CMS](https://www.cosmicjs.com/) account.
19+
- A [Stripe](https://stripe.com/en-br) account.
1620

17-
🛒 Product management and checkout using Stripe
21+
> **Note**: this template uses [Application Accelerator](https://www.azion.com/en/documentation/products/build/edge-application/application-accelerator/), [Edge Functions](https://www.azion.com/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.
1822
19-
⚡️ Performance optimized
23+
Fill in the fields presented on the configuration form and deploy the template. This will create a new edge application with its configurations, which you can edit and manage later. It also creates a repository in your GitHub account, based on the template, allowing you to maintain control over the project.
2024

21-
👁 Draft preview ready
25+
---
2226

23-
📱 Mobile responsive
27+
## Deploy your own
2428

25-
🌎 Localization ready
29+
Deploy your own CosmicJS Agency Website project with Azion.
2630

27-
🌓 Dark mode ready
31+
[![Deploy Button](https://www.azion.com/button/)](https://console.azion.com/create/cosmic/cosmic-agency-website "Deploy with Azion")
2832

29-
🔧 Customizable
30-
31-
♿️ Accessible
32-
33-
🦺 Type safe
34-
35-
![blocks.png](https://imgix.cosmicjs.com/271670f0-b156-11ee-9844-f9a09795e2a3-blocks.png)
36-
![blocks.png](https://imgix.cosmicjs.com/0bf19f40-b16d-11ee-9844-f9a09795e2a3-blocks.png)
37-
38-
## Getting started
39-
40-
1. [Install this template in Cosmic](https://www.cosmicjs.com/marketplace/templates/agency).
41-
42-
2. Download this code repository and install the dependencies.
43-
44-
```bash
45-
git clone https://github.com/cosmicjs/agency-template
46-
cd agency-template
47-
bun install
48-
```
49-
50-
3. Create a `.env.local` file with your Cosmic API keys. Find these after logging in to the Cosmic dashboard in [Project > API keys](https://app.cosmicjs.com/?redirect_to=?highlight=api-keys).
51-
52-
```
53-
cp .env.example .env.local
54-
```
55-
56-
It will look like this:
57-
58-
```
59-
# .env.local
60-
AGENCY_COSMIC_BUCKET_SLUG=change_to_your_bucket_slug
61-
AGENCY_COSMIC_READ_KEY=change_to_your_bucket_read_key
62-
AGENCY_COSMIC_WRITE_KEY=change_to_your_bucket_write_key
63-
AGENCY_STRIPE_PUBLISHABLE_KEY=change_to_your_stripe_public_key
64-
AGENCY_STRIPE_SECRET_KEY=change_to_your_AGENCY_STRIPE_SECRET_KEY
65-
```
66-
67-
4. Run the template.
68-
69-
```
70-
bun dev
71-
```
72-
73-
Open [http://localhost:3000](http://localhost:3000).
33+
For a more detailed step-by-step, check the [documentation](https://www.azion.com/en/documentation/products/guides/cosmic-agency-website/).
Original file line numberDiff line numberDiff line change
@@ -1,46 +1,31 @@
1-
# Simple Next.js Blog
1+
# CosmicJS Simple Next.js Blog
22

3-
![simple-nextjs-blog](https://github.com/cosmicjs/simple-nextjs-blog/assets/1950722/64b6673a-e25b-4124-93ed-bb57a6a35211)
3+
The **CosmicJS Simple Next.js Blog** template helps you create and manage a blog easily, combining [Next.js](https://nextjs.org/docs)'s performance with [Cosmic](https://www.cosmicjs.com/) headless CMS for content management.
44

5-
### React + Next.js + Cosmic
5+
This repository is an example of the new GitHub repository created during the deployment. For a more detailed step-by-step to deploy this template through Azion's platform, check the [How to deploy edge applications with CosmicJS Simple Next.js Blog](https://www.azion.com/en/documentation/products/guides/cosmic-simple-next-blog/) guide.
66

7-
This blog uses Next.js to create a React blog. It uses Next.js 15 and the new [Partial Prerendering](https://vercel.com/blog/partial-prerendering-with-next-js-creating-a-new-default-rendering-model) to optimize performance and user experience. It connects to the Cosmic API via the [Cosmic JavaScript SDK](https://www.npmjs.com/package/@cosmicjs/sdk).
7+
This template uses Next.js version `14.2.5`.
88

9-
### Opimized for speed and performance
10-
<img width="901" alt="simple-next-blog" src="https://github.com/user-attachments/assets/e53ef1be-f5a3-4d5a-9eac-4ddd6b32cec4">
9+
---
1110

12-
## Getting Started
11+
## Requirements
1312

14-
1. Log in to Cosmic and install the [Simple Next.js Blog template](https://www.cosmicjs.com/marketplace/templates/simple-nextjs-blog).
15-
2. Run the following commands to install the code locally.
13+
Before using this template, you need to:
1614

17-
```
18-
git clone https://github.com/cosmicjs/simple-nextjs-blog
19-
cd simple-nextjs-blog
20-
```
15+
- Have a [GitHub account](https://github.com/signup).
16+
- Every push will be deployed automatically to the main branch in this repository to keep your project updated.
17+
- A [Cosmic CMS](https://www.cosmicjs.com/) account.
2118

22-
#### Environment Variables
19+
> **Note**: this template uses [Application Accelerator](https://www.azion.com/en/documentation/products/build/edge-application/application-accelerator/), [Edge Functions](https://www.azion.com/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.
2320
24-
1. Create an `.env.local` file to gain API access to your Cosmic Bucket. To do this, run:
21+
Fill in the fields presented on the configuration form and deploy the template. This will create a new edge application with its configurations, which you can edit and manage later. It also creates a repository in your GitHub account, based on the template, allowing you to maintain control over the project.
2522

26-
```
27-
cp .env.example .env.local
28-
```
23+
---
2924

30-
2. Find your API access keys at <em>Bucket Settings &gt; API Access</em> after logging into [your Cosmic dashboard](https://app.cosmicjs.com/login) and add them to the `.env.local` file. It should look something like this:
25+
## Deploy your own
3126

32-
```
33-
COSMIC_BUCKET_SLUG=your-bucket-slug
34-
COSMIC_READ_KEY=your-bucket-read-key
35-
```
27+
Deploy your own CosmicJS Simple Next.js Blog project with Azion.
3628

37-
#### Run in development
29+
[![Deploy Button](https://www.azion.com/button/)](https://console.azion.com/create/cosmic/cosmic-simple-nextjs-blog "Deploy with Azion")
3830

39-
Install all dependencies and run in development mode.
40-
41-
```
42-
yarn
43-
yarn dev
44-
```
45-
46-
Open [http://localhost:3000](http://localhost:3000).
31+
For a more detailed step-by-step, check the [documentation](https://www.azion.com/en/documentation/products/guides/cosmic-simple-next-blog/).

0 commit comments

Comments
 (0)