Editing the content — Goeboek Next.js
All the words and images of this Next.js template live in src/content/ and public/images/, in plain TypeScript files you edit while npm run dev shows the result.
No CMS is needed: text goes between quotes and items are separated by commas. If you would rather manage content in Sanity, Payload, Strapi or Directus, see Using a headless CMS.
src/content/ site.ts name, title, description, domain, logo, header, contact details, social links, footer sections.ts the call to action, the property cards' labels, the listing filter, the rating label pages/home.ts Home's hero, Featured Properties, About block and blog title pages/*.ts the copy of every other page collections/*.ts properties, agents, locations, categories, posts and testimonials routes.ts the URL of every page types.ts the fields each kind of item hasNot sure which file holds a piece of text? The page maps label every section of every page with the file that renders it.
Your details first
Section titled “Your details first”src/content/site.ts holds what appears on every page:
| Export | Shown where |
|---|---|
site.name |
The browser title suffix (“Marble House | Goeboek”) and the share cards |
site.title |
Home’s browser title, used whole, and the default of any page without its own |
site.description |
Search results and share cards for Home. It describes the template: write yours. |
site.url |
Set this to your domain before publishing. Canonical links, share links, sitemap.xml and robots.txt are built from it. |
site.logo |
The logo: the round mark’s file, the name in two lines (“Goeboek” / “properties”) and what screen readers read for it (Making it look like your brand) |
navigation |
The header’s four links (and the phone menu): Home, Property, Blog and About Us |
headerActions |
The header’s two buttons: “Add Property” (to /add-property) and “Contact us” (to /contact; left out on tablets) |
menu |
The phone menu button’s two labels (“Menu”, “Close”) |
contact |
The office address, the two phone numbers, the e-mail (hello@example.com) and the three lines of opening hours, shown in the footer and on the Contact page |
socials |
The footer’s four social links (Instagram, Facebook, Youtube, Twitter; the demo’s open the networks’ home pages) |
footer |
The footer’s text and “Contact Us” button, its link columns (Categories, Links), the copyright line and “Follow us:” |
Phone numbers are written as you want them shown ("(123) 456-7890"); their links dial the digits only. The copyright
line’s {year} becomes the current year. Point the social links to your own profiles and remove the ones you don’t use.
The demo’s name appears in many places: “Goeboek” in site, the logo, the footer text, the copyright line (“Copyright ©
{year} - Goeboek by Marcframe. All rights reserved.”), the testimonials and most page texts. Search src/content/ for
“Goeboek” to find them all.
Home, section by section
Section titled “Home, section by section”src/content/pages/home.ts holds Home’s copy, in the order it appears. Change the text between the quotes, keeping the
field names: the sections read them by name. Apostrophes are safe inside double quotes, and the demo uses both ’ and the
typographic ’.
| Field | Section | What it holds |
|---|---|---|
hero |
The hero | title (the page’s <h1>), text, action (“See all Property” → /property), stats (two facts: “150” Property Available, “87” Property Sold), testimonials (the label “Top Testimonial”, count: the first 5 testimonials in a slideshow, and “More Details” → /about#testimonials) and slideshow (count: the first 4 properties as large cards, and their labels: Beds, Bath, m2, “Price :”, Agent, Contact, “Request a tour”) |
featured |
Featured Properties | title, offset (4) and count (6): the six properties after the first four, and “More Property” → /property |
about |
About | label, title, text, the two images, details (the second text) and “More about Us” → /about |
blog |
The latest posts | title and count (the 4 newest posts) |
The facts in stats are typed numbers, not counts of the collection: write your own. The hero, Featured and the
listings take properties in the order of properties.ts, so the first four of the file are the slideshow and the next
six are Featured; there is no “featured” switch.
src/content/sections.ts holds copy that several pages share:
| Export | What it holds |
|---|---|
cta |
The call to action on Home and About: label, title, text, the photo and the two buttons (“Get Started” → /property, “Contact Us” → /contact) |
propertyCard |
The cards’ type tags (“For Rent”, “For Sale”) and the size unit (“m2”) |
filters |
The listing pages’ title row (label, title, text), the filter’s heading (“Explore:”), its lead and group labels (Type with All, Sell and Rent; Category; Location; Agents), pageSize (6 cards before “Load More” on /property), “Load More” and the phone toggle’s names for screen readers |
testimonial |
What screen readers read for a score: “Rated {rating} out of 5” |
The other page files:
| File | What it holds |
|---|---|
properties.ts |
The titles and descriptions of the listing pages (meta, with {name} for a location or category) and noindex: the three empty default listings kept out of search results |
property.ts |
The labels of a property page (type tags, “Property ID:”, Price, Size, “Contact Sales”, Description, “Property features”, the details and utility rows, Video, Location and “Show on map”, the agent’s contact labels and “View My Property”), the tour form (tour, Forms), “More in {location}” with count (2) and “Related properties” with count (3) and “More Property” |
agent.ts |
An agent page’s browser title and description ({name}), its title and text, the contact labels and “Explore: {name}” |
blog.ts |
The blog’s browser title, description and title |
post.ts |
“By {author}”, the sidebar’s about text, “Recent posts” (count 3), “Latest Property” (count 1) and the related posts’ title (count 4) |
about.ts |
The page title and photo, “Our Journey to Excellence” with its three paragraphs, the three values with two photos, and the testimonials block (id testimonials, 6 cards before “Load More”, 4 below 1200 px) |
contact.ts |
The page title, the map’s search (map.query), the labels of the contact details and the contact form |
add-property.ts |
The page title and every group and field of the Add property form (Forms) |
success.ts |
The two thank-you pages (tour, property): title, subtitle, text, illustration and button |
not-found.ts |
The 404 page: its browser title, the title, “404”, the two lines and “Return to Homepage” |
Every page file but Home’s and the 404’s has a meta with its browser title and its description (the 404 has a title
only).
Collections
Section titled “Collections”src/content/collections/ holds the lists the site builds pages and sections from:
| File | Items | What it feeds |
|---|---|---|
properties.ts |
21 | Home’s slideshow (the first 4) and Featured (the next 6), every listing, one page per property at /property/<slug>, the post pages’ “Latest Property” (the first one) |
agents.ts |
4 | One page per agent at /agent/<slug>, the agent on every property card and page, the filter |
locations.ts |
6 | One listing per location at /location/<slug>, the cards’ meta line, the filter |
categories.ts |
5 | One listing per category at /property-category/<slug>, the cards’ meta line, the filter |
posts.ts |
12 | Home’s latest posts, the blog, one page per post at /blog/<slug> |
testimonials.ts |
12 | Home’s hero (the first 5) and About (all, 6 at a time) |
Every collection keeps the order of its file, except posts, which are sorted by date, newest first. Two posts of
the same date keep the order of the file.
The last agent, location and category of each file are the original design’s defaults: “No Name” (no-name, no photo
and no details), “No Location” (no-location) and “Uncategory” (uncategory). No property uses them; they have pages
that list nothing, which are kept out of search results and the sitemap (noindex in properties.ts) and out of the
filter. They are also the fallbacks: a property whose agent, location or category names no item shows “No Name”,
“No Location” or “Uncategory” instead (src/lib/to-ui.ts), so keep them unless every property names an existing item.
Adding a property
Section titled “Adding a property”Copy an existing entry, paste it into the list in properties.ts (mind the comma between entries), and change the
values:
{ "slug": "garden-loft", "title": "Garden Loft", "propertyId": "55G101", "for": "rent", "category": "apartments", "agent": "steve-parker", "location": "queens", "address": "12-34 Main St, Queens, NY 11354, USA", "price": 2400, "duration": "/month", "image": { "src": "/images/property-garden-loft.jpg", "alt": "A bright loft with a sofa facing tall windows" }, "gallery": [ { "src": "/images/property-garden-loft-2.jpg", "alt": "…" }, { "src": "/images/property-garden-loft-3.jpg", "alt": "…" }, { "src": "/images/property-garden-loft-4.jpg", "alt": "…" }, { "src": "/images/property-garden-loft-5.jpg", "alt": "…" } ], "excerpt": "A bright two-bedroom loft above a quiet garden in Queens.", "description": [{ "type": "paragraph", "text": "**Garden Loft** is …" }], "features": [{ "type": "paragraph", "text": "Welcome to **Garden Loft**, …" }], "video": "https://www.youtube.com/watch?v=…", "details": { "size": 90, "bedrooms": 2, "bathrooms": 1, "floor": "Second", "additionalSpace": "Balcony", "furnishing": "Semi furnished", "ceilingHeight": 3, "constructionYear": "2007-07-01", "renovation": "2019-03-01" }, "utility": { "heating": "Natural gas", "airCondition": "Yes", "fireplace": "-", "elevator": "Yes", "ventilation": "Yes", "intercom": "Yes", "windowType": "Aluminum frame", "cableTv": "-", "wifi": "Yes" }}The quotes around the field names come from the way the files are generated; they are optional in TypeScript, so keep them or leave them out.
slugis the URL:/property/garden-loft.titleis the card’s title, the page’s<h1>and its browser title.propertyIdis shown on the page and filled into the tour form, so a request names the property.foris"rent"or"sell": the type tag (“For Rent”, “For Sale”) and the Type listings.category,agentandlocationare theslugs of items incategories.ts,agents.tsandlocations.ts.addressis shown under Location; “Show on map” opens Google Maps on it.priceis a number in dollars, shown as “$2,400”;durationfollows it (“/month” for rent,""for sale).imageis the card’s photo, the page’s main photo and the picture shown when the property is shared.galleryholds more photos: the page shows the first four in a 2 × 2 grid, and a hovered card steps through the main photo and the first two.excerptis the card’s text and the page’s search description.descriptionandfeaturesare rich text.videois a YouTube link, shown as an embedded player; leave the field out to hide the Video block. The demo’s 21 properties share one video: give each its own.details:sizein square metres,ceilingHeightin metres,constructionYearandrenovationas ISO dates (shown as “Jul 1, 2007”); the rest is text.utility: “Yes”, “-” or a word (“Natural gas”).
The page ends its sidebar with “More in
Adding an agent
Section titled “Adding an agent”{ "slug": "maya-lee", "name": "Maya Lee", "image": { "src": "/images/agent-maya-lee.jpg", "alt": "Maya Lee smiling in a navy blazer" }, "address": "560 3rd Ave, New York, NY 10016, USA", "phone": "+2224445557", "mobile": "+3336669991", "whatsapp": "3336669991", "email": "maya@example.com", "bio": "Maya helps families find their first home in Queens and Brooklyn."}The agent page is /agent/maya-lee: the agent’s card (photo, address, office phone, mobile, WhatsApp, e-mail and bio)
above the filter, and every property whose agent is maya-lee. Phones are written as they are dialled; WhatsApp
without the + (its link is https://wa.me/<number>). “Contact Sales” on a property page calls the agent’s mobile.
An agent with a photo shares it when the page is shared.
Adding a location or a category
Section titled “Adding a location or a category”{ "slug": "jersey-city", "name": "Jersey City" }Each gets a listing page (/location/jersey-city, /property-category/<slug>), a link in the filter and its name on the
cards of its properties. The Add property form’s Location and Property Category choices are typed in
add-property.ts, not read from the collections: add the name there too.
Adding a post
Section titled “Adding a post”{ "slug": "choosing-your-first-home", "title": "Choosing Your First Home", "category": "Improvement", "date": "2026-11-02", "author": "Javier Marc", "image": { "src": "/images/post-choosing-your-first-home.jpg", "alt": "Keys on a kitchen table beside a floor plan" }, "excerpt": "Five questions to ask before you sign for your first home.", "body": [ { "type": "paragraph", "text": "First paragraph, with a **bold** phrase." }, { "type": "paragraph", "text": "Another paragraph." } ]}slugis the URL:/blog/choosing-your-first-home;titlethe card’s title, the page’s<h1>and its browser title.categoryis plain text, not a reference (the demo’s are Improvement, Development and Design). The post’s related posts are up to four other posts with exactly the same category, newest first (three on laptops and phones). There are no category pages for posts.date("2026-11-02") is shown as “Nov 2, 2026”, and sorts the lists.authorshows as “By Javier Marc”.imageis the card’s photo, the cover of the post and the picture shown when it is shared.excerptis the card’s text and the post’s search description;bodyis the article.
A post page’s sidebar shows the about text, “Recent posts” (the three newest, the open one included) and “Latest
Property” (the first property of properties.ts).
Adding a testimonial
Section titled “Adding a testimonial”{ "slug": "jane-d", "name": "Jane D.", "photo": { "src": "/images/testimonial-jane-d.jpg", "alt": "Portrait of Jane D." }, "rating": 4.7, "quote": "\"They found us a home in two weeks.\""}rating is a score out of 5, shown with a star, or null to show none. The first five testimonials of the file are
Home’s slideshow; About shows them all, six at a time (four below 1200 px). The demo’s quotes keep the original design’s
straight quotation marks inside the text.
Removing an item
Section titled “Removing an item”Delete the entry. Its own page and its sitemap entry disappear on the next build. Before deleting an agent, a location or a category, move its properties to another one: their cards would otherwise show the default (“No Name”, “No Location”, “Uncategory”).
What each field means
Section titled “What each field means”src/content/types.ts is the reference: it lists every field and a comment for the ones that are not obvious. Your
editor shows the same information while you type, and npm run build names the file and the line of a missing or
mistyped field.
Rich text: properties and posts
Section titled “Rich text: properties and posts”A property’s description and features and a post’s body are lists of blocks. The demo uses paragraphs only, with
bold words (the property’s name at the start of its texts):
[ { "type": "paragraph", "text": "**South Sunlight Apartment** is a radiant urban residence …" }, { "type": "paragraph", "text": "Another paragraph." }]Words between double asterisks are bold (**…**), words between backticks are code. There are no italics, links or
images inside the text.
The RichText component that draws the blocks (src/design-system/components/patterns/RichText.tsx) also draws
headings ({ "type": "heading", "level": 3, "text": "…" }, levels 2 to 6) and lists
({ "type": "list", "ordered": false, "items": ["…", "…"] }, numbered with "ordered": true). The content type in
src/content/types.ts allows paragraphs only, as the demo needs: to write headings or lists, replace RichTextBlock in
types.ts with the one exported by RichText.tsx (import type { RichTextBlock } from "@/design-system").
Images
Section titled “Images”- Put the file in
public/images/. - Refer to it in the content as
/images/<file>(the path starts atpublic), with analt.
Sizes and formats are handled for you: pages use next/image, which serves a scaled, modern format per device. The
download’s placeholders show the size of each demo photo; use photos at least as large as the frames:
| Photos | Demo size | Frame |
|---|---|---|
A property’s image |
300 to 1400 wide (most 1024 × 644 or 1400 × 785) | 1.536 : 1 on the cards; about 16 : 9 on its page (up to 940 px wide); 500 to 680 px tall in Home’s slideshow |
A property’s gallery |
300 to 1200 wide | 16 : 9 tiles in the page’s 2 × 2 grid; the card’s frame when hovered |
An agent’s image |
400 × 504 | round, 82 px on the agent card, 50 px on the cards |
A post’s image |
1400 wide (933 to 2100 tall) | 0.84 : 1 (taller than wide) on the cards; 1.46 : 1 on its page |
A testimonial’s photo |
70 to 200 px | 24 px round |
About’s photos (about-hero, about-1, about-2) |
1920 × 1280, 1200 × 800, 1200 × 1800 | 2.2 : 1 (1.4 : 1 on phones); 1.53 : 1; the height of the column |
The call to action’s photo (cta) |
1920 × 1282 | the full block, under a dark veil |
Photos in a fixed frame are cropped to fill it, so a photo of other proportions works, but you lose the edges the frame
cuts. The logo’s mark (logo-mark.svg) and the two illustrations of the thank-you pages (success-tour.svg, success-property.svg)
are drawings, not photos, and ship as they are.
Every photo comes with a short description for screen readers and search engines: alt in { src, alt }. Write one
for each photo you change.
Text that is not in content/
Section titled “Text that is not in content/”Almost every word is content, including the forms’ messages and the screen-reader names of the filter toggle and the scores. The few interface words that never change per site live in the code:
- “Previous”, “Next” and “Go to slide {n}” (the slideshow buttons, for screen readers) in
src/design-system/components/media/Slideshow.tsx; - the date and price formats (“May 16, 2024”, “$1,200”) in
src/lib/format.ts; - the page’s language,
lang="en", and the share cards’localeinsrc/app/layout.tsxandsrc/lib/meta.ts.
Search for the word and you will find it.
After editing
Section titled “After editing”npm run buildA successful build means every content file has the fields it needs and every page still renders. It doesn’t check that
the images exist, that a property’s agent, location or category names an existing item (it falls back to the
default), or that links written as text ("/about#testimonials") lead somewhere: click through the site once with
npm start after big changes. See Going live for the rest of the checklist.