Back to blog
Mar 14, 2023
3 min read

Astro Sphere: Adding a new post or project.

Adding a new article (blog post or project) is pretty easy.

Basics

Create a folder in the respective collection you wish to create content. The name of the folder will be the slug in which your content will be found.

creating the following

/content/blog/my-new-post/index.md

will be published to

https://yourdomain.com/blog/my-new-post

Frontmatter

Front matter is in yaml if you are familiar with the format. All posts and projects require frontmatter at the top of the document to be imported. All frontmatter must be inside triple dashes, similar to Astro format. See example below.

Blog Collection

FieldTypeReq?Description
titlestringyesTitle of the post. Used in SEO.
summarystringyesShort description of the post. Used in SEO.
datestringyesAny string date that javascript can convert. Used in sorting
tagsarrayyesPost topic. Array of strings. Used in filtering.
draftbooleannoHides the post from collections. Unpublished entry.

Example blog post frontmatter

---
title: "Astro Sphere: Adding a new post or project."
summary: "Adding a new article (blog post or project) is pretty easy."
date: "Mar 18 2024"
draft: false
tags:
- Tutorial
- Astro
- Astro Sphere
---

Projects Collection (extends Blog Collection)

FieldTypeReq?Description
titlestringyesTitle of the post. Used in SEO.
summarystringyesShort description of the post. Used in SEO.
datestringyesAny string date that javascript can convert. Used in sorting
tagsarrayyesPost topic. Array of strings. Used in filtering.
draftbooleannoHides the post from collections. Unpublished entry.
demoUrlstringnoA link to the deployed project, if applicable.
repoUrlstringnoA link to the repository, if applicable.

Example project frontmatter

---
title: "Astro Sphere"
summary: "Astro Sphere, a portfolio and blog for designers and developers."
date: "Mar 18 2024"
draft: false
tags:
- Astro
- Typescript
- Javascript
- Tailwind
- SolidJS
demoUrl: https://ashutoshpith.com
repoUrl: https://github.com/ashutoshpith
---

Write your content

You’ve made it this far, all that is left to do is write your content beneath the frontmatter. Writing markdown will be covered in the next article.