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.