Skip to content
Sign inJoin waitlist

Editing the site — Goeboek HTML

Every page of Goeboek’s HTML edition is a plain file you edit in a code editor: where everything is, and how to change the texts, add a property, a post or an agent, or add a page.

Double-click index.html: the site opens in your browser and every link between pages works, straight from the folder. To see it exactly as a host serves it (and to test the forms and the 404 page), run a small local server from the folder:

Terminal window
npx serve .

npm start runs the same command. Then edit the files in a code editor and reload the browser to see the change.

index.html Home
property.html every property, six at a time, beside the filter
type/sell.html the properties for sale (6 in the demo)
type/rent.html the properties for rent (15)
location/*.html one listing per location (6, with No Location)
property-category/*.html one listing per category (5, with Uncategory)
agent/*.html one listing per agent, with the agent's card (4, with No Name)
property/*.html one page per property (21)
blog.html every post
blog/*.html one page per post (12)
about.html, contact.html
add-property.html the form to submit a property
success-scheduled.html where "Schedule tour" leads once sent
success-add-property.html where Add property leads once sent
404.html shown for addresses that don't exist
style-guide.html every component with its name (noindex; delete it if you don't want it)
assets/css/style.css the stylesheet (generated — see design.md)
assets/js/main.js the site's scripts (you rarely need to touch it)
assets/js/config.js your settings: form endpoint
assets/images/ photos, the logo's mark and the two thank-you illustrations
assets/fonts/ Plus Jakarta Sans, Inter
icon.png, apple-icon.png the browser icon and the home-screen icon
sitemap.xml, robots.txt
src/css/style.css the stylesheet's source: colours, breakpoints, fonts

Pages describes every page, section by section.

Find the words on the page and change them in the HTML. Keep the tags and classes around them, because they carry the layout. A property card’s title looks like this:

<h3 class="text-xl leading-[1.2] font-medium md:text-[22px] lg:text-2xl w-full">
<a href="property/south-sunlight-apartment.html" …>South Sunlight Apartment</a>
</h3>

Change the words, leave the class. Long lines are wrapped onto several lines in the files, so when you search for a sentence, search for a few words of it. Ampersands are written &amp;, and the demo uses both ’ and the typographic ’ (Let’s Talk). Typing ' and " in text works too; & should stay &amp;.

Dates are written twice: <time datetime="2024-05-16">May 16, 2024</time>. The datetime is the date in year-month-day form, for search engines; the text is what the visitor reads.

The header and the footer are copied into every page. Change them once for all files with your editor’s Find in Files / Replace in Files (VS Code: Ctrl/Cmd + Shift + H):

Replace With
https://goeboek-html-marcframe.vercel.app Your domain, e.g. https://www.youragency.com (canonical links, share cards, sitemap.xml, robots.txt)
aria-label="Goeboek" Your name: the name of the logo links, for screen readers
<span class="block">Goeboek</span> and <span class="block">properties</span> The two lines of your name in the logo (Design)
Goeboek by Marcframe. All rights reserved. Your footer line (the year before it is written by the script: <span data-current-year>)
| Goeboek</title> and | Goeboek" in share tags | Your Agency (Home’s title, Goeboek - Real Estate and Property Website, has no suffix)
content="Goeboek" Your site’s name (application-name and og:site_name)
Goeboek is your trusted partner in real estate, … The footer’s text (also the “about” box of every post page)
123 Main Street, Suite 456, Cityville, ST 78901 Your address (the footer, and contact.html with its map)
(123) 456-7890 and tel:1234567890, (987) 654-3210 and tel:9876543210 Your phone numbers: the text and the link (digits only)
hello@example.com Your e-mail (the footer and contact.html)
https://instagram.com, https://facebook.com, https://youtube.com, https://x.com Your profiles (the footer’s “Follow us:”)

Include the .html, .xml and .txt files. Review each change before replacing all. “Goeboek” also appears inside the texts (the About page, the call to action, the forms’ introductions, the descriptions): search for it once you are done.

Block Pages
Header, with the phone menu Every page (the 404’s links start at the site’s root, /index.html)
Footer: the logo, the text, the contacts, the two link columns, the copyright and the social links Every page
A property’s card property.html, the listings of its type, location, category and agent, other properties’ “More in” and “Related properties”, Home (the first ten), “Latest Property” on every post (the first property)
A post’s card blog.html, Home (the four newest), “Recent posts” on every post (the three newest), the related posts of the posts of its category
An agent’s photo and name Every card of that agent’s properties; the agent’s card on their own page and on their properties’ pages
The call to action (“Let Us Help You Find the Perfect Home Today”) Home and About
The filter (Type, Category, Location, Agents) Every listing page

Search the folder for a property’s or a post’s file name (south-sunlight-apartment) to find every card of it.

index.html holds, in order:

  • The hero: the title (the page’s <h1>), the text and “See all Property”; the two numbers (“150 Property Available”, “87 Property Sold”); “Top Testimonial” with five testimonials in a slideshow and “More Details” (to about.html#testimonials); then the first four properties as large cards in a slideshow, each with its photo, beds, bath and size, price, agent and “Request a tour” (to the property’s page).
  • Featured Properties Just for You: six property cards (the fifth to tenth properties of the demo) and “More Property”.
  • About Us: the title, the two texts, two photos and “More about Us”.
  • The call to action: the photo, the texts, “Get Started” and “Contact Us”.
  • Stay Updated with Our Latest Insights: the four newest posts.

The slideshows are boxes marked data-slideshow, with data-count (the number of slides: 5 testimonials, 4 properties) and data-interval (milliseconds between slides: 4000 and 8000). Each list is written with its first slide repeated at the end (so the loop has no gap); the properties’ slideshow also has one dot button per slide. When you add or remove a slide, do it in the list, in the copy at the end if it is the first, and in the dots, and set data-count.

A property card shows the photo, the type (“For Rent”, “For Sale”), the agent’s photo and name, the category and the location, the title, the first sentence of the description, the price and the size, beds and baths. On hover it runs through three photos — the card photo and the first two gallery photos — in a slideshow written inside the card (data-slideshow, data-count="3", hidden until hovered). Copy a whole <li> with its <article data-property-card> and change the links, the photos (in the card and in its slideshow) and the texts.

property.html lists every property and shows six at a time: the cards after the sixth carry hidden tabindex="-1", and “Load More” shows six more per click (the box’s data-page-size="6"; data-count is the number of cards). When you add a card, keep the first six without hidden and every later one with it.

The type, location, category and agent pages list their properties all at once, without “Load More”. The filter beside them is links to the other listings (type/sell.html, location/brooklyn.html …), with the current one marked (aria-current="page"); on phones it folds behind a button. The three empty defaults (No Location, Uncategory, No Name) are not in it. A new location, category or agent needs its own listing page and a link in the filter of every listing page.

  1. The page. Copy an existing one, e.g. property/south-sunlight-apartment.html → property/garden-loft.html. Use lower-case words joined by - for the file name; it becomes the address. Edit:

    • the type, the title (<h1>), the category and location links, the Property ID, the price (with /month for a rental), the size;
    • “Contact Sales” (a tel: link to the agent’s mobile);
    • the main photo and the four gallery photos (src, alt, width and height);
    • Description and Property features (the text of a property or a post), the details and the utilities;
    • the video (src="https://www.youtube.com/embed/<video id>" on the <iframe>, and its title), the address and the “Show on map” link (a Google Maps search of the address);
    • the agent’s card (photo, name, phones, WhatsApp, e-mail, “View My Property”);
    • “Schedule tour”: the value and placeholder of the Property ID and Property Name fields;
    • “More in ”: two other properties of the same location; “Related properties”: up to four of the same category and type (the fourth is hidden from 1200 px);
    • the <head>: title, description, canonical, og:url, the og: and twitter: titles and descriptions, the share image (og:image, twitter:image: the main photo’s full address) and its alt text.
  2. The listings. Add its card (property cards) to property.html and to the listings of its type, location, category and agent.

  3. The other properties whose “More in” or “Related properties” should show it, and Home if it should be featured.

  4. The sitemap. Add a line to sitemap.xml:

    <url><loc>https://yourdomain.com/property/garden-loft.html</loc></url>
  1. The page. Copy one in blog/ and rename it. Edit the title (<h1>), the date, the category, “By Javier Marc”, the cover, the text, the related posts at the bottom (up to four other posts of the same category, newest first) and the <head> as for a property.
  2. The lists. Put its card at the top of blog.html and of Home’s latest posts (and remove the card that becomes fifth there), and in “Recent posts” of every post (the three newest).
  3. The posts of its category, whose related posts should show it.
  4. The sitemap. Add a line to sitemap.xml.

To remove a property or a post, do the reverse: delete the page, its cards and its line in sitemap.xml. Search the folder for the file name to catch any link left behind.

An agent page (agent/steve-parker.html) shows the agent’s card — photo, address, office phone, mobile, WhatsApp (https://wa.me/<number>), e-mail and text — above the filter, and the agent’s properties. To add an agent, copy a page in agent/, change the card and the cards it lists, add the agent to the filter’s “Agents” of every listing page and to sitemap.xml. The agent’s photo and name are also on each of their property cards and property pages.

The text sits in a <div> (a property has two: under “Description” and “Property features”), and uses two tags:

Block HTML
Paragraph <p class="not-first:mt-5">
Bold <strong class="font-bold">

The demo’s texts are paragraphs with a few bold words (often the property’s name). Copy the tags from a page rather than typing them, so that every class is one the stylesheet already has.

assets/images/ holds every photo. The easiest change is to replace a file with yours under the same name: every page that shows it updates. The download ships with grey placeholders that state the size each image was designed for (for example 1024 × 644).

To use a new file instead, change the src: <img src="assets/images/my-photo.jpg" …>. In pages inside a folder (property/…, blog/…, agent/…), the path starts with ../: src="../assets/images/my-photo.jpg". In 404.html it starts at the site’s root: src="/assets/images/…". The width and height on the <img> are the photo’s own size: write your photo’s, so that the browser keeps its space while it loads.

Every photo sits in a fixed frame and is cropped to fill it (object-cover), so a photo of other proportions works, but you lose the edges the frame cuts. Use photos at least as large as the demo’s:

Photos Files Demo size
A property’s photo (its cards, the top of its page, its share image) property-<slug>.jpg 300 to 1400 wide (most 1024 × 644 or 1400 × 785); about 1.5 : 1 on the cards, 16 : 9 on its page
A property’s gallery property-<slug>-2.jpg … -5.jpg 300 to 1200 wide; 16 : 9 tiles
A post’s cover post-<slug>.jpg 1400 wide
An agent’s photo (round) agent-<slug>.jpg 400 × 504
A testimonial’s photo (round, 24 px) testimonial-<name>.jpg 70 to 200 px
About’s photo, the call to action about-hero.jpg, cta.jpg 1920 wide
The About photos (Home and About) about-1.jpg, about-2.jpg 1200 × 800, 1200 × 1800

Use .jpg for photos and keep files small; compress them with Squoosh or TinyPNG. Write an alt text for every photo that carries meaning (the demo describes each one). The logo’s mark (logo-mark.svg) and the thank-you illustrations (success-tour.svg, success-property.svg) are drawings, not placeholders.

Pages link to each other as index.html, property/<slug>.html, blog/<slug>.html; from inside a folder, add ../ (../contact.html). Keep the .html: it’s what lets the site work from any host and from disk. The links and images of 404.html start at the site’s root (/index.html), because it is shown at any address.

The phone numbers are tel: links (digits only), the e-mails mailto: links, WhatsApp https://wa.me/<number>. The social links lead to the networks’ home pages until you change them.

  1. Copy a page that has the layout you want, e.g. about.html to services.html in the root.
  2. Replace the blocks inside <main …> with the ones you want. Every block in the template can be copied from its page (or from style-guide.html) and pasted between <main …> and </main>.
  3. Update the <head> (title, description, canonical, og:url, and the og: and twitter: titles and descriptions; remove the og:image tags or point them at a picture of the page).
  4. Link to it: in the header’s menu, copy the <li> of a neighbouring link and change its href and its text. Keep data-close-menu on the links: it closes the phone menu when the link is pressed. Do it in every page, or add the link to a column of the footer. Add the page to sitemap.xml.

Delete the file, remove its links from the menus, the footer, the filters and the cards of every page, and its line from sitemap.xml. Search the folder for the file name to catch any link left behind.

style-guide.html shows every component with its name, which is handy for copying a card or a button. It’s hidden from search engines and linked from nowhere. Delete it before publishing if you don’t want it online.