Polaris Astro documentation
Journal, team and reviews
Add journal posts, the guides and hosts behind your trips, and guest reviews.
Journal posts, team members and reviews are Markdown files in their own folders. They don’t have pages of their own except the posts. Guides and reviews appear inside blocks.
Journal posts
Each post is a Markdown file in src/content/posts/. The file name becomes its address: choosing-a-homestay.md is published at /journal/choosing-a-homestay/. The Markdown below the front matter is the article.
---
title: "Choosing a homestay"
summary: "What a homestay offers, the questions worth asking before you book, and how to read reviews."
date: 2026-06-15
author: priya
image: post-choosing-a-homestay.jpg
imageAlt: "A loaf of fresh bread with an open crumb on a wooden board in warm light"
tags:
- "Homestays"
- "Planning"
readingMinutes: 4
featured: false
---
Write the article here, with ## headings, lists and links.
| Field | Required | What it does |
|---|---|---|
title |
Yes | The post title. |
summary |
Yes | Up to 200 characters, for cards, the page header and search results. |
date |
Yes | The publish date, such as 2026-06-15. Newest posts come first. |
author |
No | The file name of a team member in src/content/team/, without .md. |
image, imageAlt |
Yes | The main photo and its description. |
destination |
No | The file name of a destination. The destination page lists its posts. |
tags |
No | A list of tags. The journal block can show only posts with one tag. |
readingMinutes |
No | The reading time. Leave it out and the cards work it out from the word count. |
featured |
No | true makes the post eligible for blocks set to featured: true. Default false. |
draft |
No | true keeps the post off the site. Default false. |
The list of posts is the /journal/ page, built with the journal block. Your posts are also published as a feed at /journal/rss.xml.
Team
Each guide or host is a Markdown file in src/content/team/. They appear in the hosts block, on trip pages as “Your guides” (the guides of the trip’s destination), and as authors on journal posts.
---
name: "Tenzin Angchuk"
role: "Local guide"
base: "Leh, Ladakh, India"
image: "team-tenzin.jpg"
imageAlt: "Tenzin Angchuk smiling beside a line of prayer flags above a river valley"
languages:
- "English"
- "Ladakhi"
- "Hindi"
since: 2017
bio: "Tenzin grew up in a village above the Indus and has guided the Markha Valley for eight seasons."
destinations:
- ladakh
order: 3
---
| Field | Required | What it does |
|---|---|---|
name |
Yes | The person’s name. |
role |
Yes | For example Local guide. |
base |
No | Where they live. |
image |
Yes | A portrait, as a file name. |
imageAlt |
No | A description of the photo. |
languages |
No | The languages they speak. |
since |
No | The year they joined. |
bio |
Yes | A short bio, up to 240 characters. |
destinations |
No | The destinations they guide in, as file names. A trip page shows the people who guide in its destination. |
order |
No | Lower numbers come first. Default 0. |
Reviews
Each review is a Markdown file in src/content/reviews/. The file name doesn’t matter. The demo uses review-01.md, review-02.md and so on.
---
name: "Amara Okafor"
from: "Leeds, United Kingdom"
rating: 5
date: 2025-06-14
title: "Our guide made the Markha Valley feel personal"
text: "Tenzin met us at Leh airport with a clear plan and a flask of tea."
trip: markha-valley-trek
source: direct
featured: true
---
| Field | Required | What it does |
|---|---|---|
name |
Yes | The reviewer’s name. |
from |
No | Their home town or country. |
rating |
Yes | A number from 1 to 5. |
date |
Yes | When they travelled. |
title |
No | A headline for the review. |
text |
Yes | The review. |
trip |
No | The file name of the trip it is about. |
stay |
No | The file name of the stay it is about. |
source |
No | direct (the default), google, tripadvisor or trustpilot. Shows a small label on the review. |
featured |
No | true shows the review first. Default false. |
Reviews are shown by the reviews block. On a trip or stay page it shows that entry’s reviews, with the average score. Featured reviews come first, then the newest.
Only publish reviews from real guests, and the source you name should be where the review really appeared.