Polaris Astro documentation

Stays

Add your lodges, homestays, guesthouses and campsites, with rooms, amenities and check-in details.

Each stay is a Markdown file in src/content/stays/. The file name becomes its address: willow-yard-homestay.md is published at /stays/willow-yard-homestay/. Stays appear in the finder on /stays/, in the stays blocks, and on their destination’s page. Stays of type camp can be listed on their own page with stayType: camp on a finder block, as the demo does on /camping/.

---
title: "Willow Yard Homestay"
destination: ladakh
type: homestay
summary: "A family homestay in a Leh garden with apricot trees, where guests eat with the family and sleep under thick wool blankets."
priceFrom: 38
image: stay-willow-yard-homestay.jpg
imageAlt: "A view from a red-framed window over the green fields and mountains of Leh"
gallery:
  - "stay-willow-yard-homestay-2.jpg"
  - "stay-willow-yard-homestay-3.jpg"
rooms:
  - name: "Garden room"
    sleeps: 2
    beds: "One double bed"
    size: "14 m2"
    price: 38
    features:
      - "Shared bathroom with hot water"
      - "View over the apricot trees"
amenities:
  - "Wi-fi in the main house"
  - "Hot water from a solar geyser"
meals: "Breakfast and dinner with the family are included."
facts:
  road: "Paved road to the lane, then 150 m on foot."
  power: "Grid power with a battery backup for the lights and wi-fi"
  network: "4G at the house, weak in the lower garden"
  checkIn: "14:00"
  checkOut: "11:00"
trust:
  registration: "Reg. 0000-DEMO"
  host: "Tsering"
  since: 2009
  languages:
    - "English"
    - "Hindi"
    - "Ladakhi"
rules:
  - "Remove shoes before entering the house"
  - "No smoking indoors"
featured: false
order: 1
---

The story of the stay goes here, in normal Markdown.

Fields

Field Required What it does
title Yes The stay name.
destination Yes The file name of a destination in src/content/destinations/, without .md.
type Yes homestay, guesthouse, boutique, lodge, luxury or camp.
summary Yes One or two sentences for cards, the page header and search results.
priceFrom Yes The lowest price per night, as a number.
image, imageAlt Yes The main photo and its description.
gallery No More photos, as file names.
coords No lat and lng. Used by the map and the atlas line.
altitude No Metres above sea level.
rooms No The rooms. See below.
amenities No A list of short lines. Polaris picks an icon from the words in each.
meals No A line about meals.
facts No Any of road, power, network, checkIn and checkOut.
trust No Any of registration, host, since (a year or text) and languages.
rules No House rules, as short lines.
featured No true makes the stay eligible for blocks set to featured: true. Default false.
order No Lower numbers come first. Default 0.

Rooms

Field Required What it does
name Yes The room name.
sleeps Yes How many guests it takes.
price Yes The price per night, as a number.
beds No For example One double bed.
size No For example 14 m2.
image No A photo of the room, as a file name.
features No Short lines shown as chips.

The booking box on a stay page lets the visitor choose a room.

What the stay page shows

The stay page is a gallery, an overview with the booking box, the rooms, the amenities with meals and house rules, the trust kit (trust and facts), a map, reviews of the stay and more stays. See Pages and blocks to change the layout.

The map uses the stay’s coords, or the coordinates of its destination if the stay has none.

Guest reviews of a stay come from the reviews collection. See Journal, team and reviews.