Editing the site — Kendi HTML
Every page of Kendi is a plain HTML file that you edit in a code editor. This guide shows where everything is, and how to add a post, a category, an author or a page.
Open it
Section titled “Open it”Double-click index.html: the site opens in your browser and every link 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:
npx serve .npm start runs the same command. Then edit the files in a code editor and reload the browser to see the change.
What is where
Section titled “What is where”index.html, about.html, contact.htmlblog.html Articles: every post, six at a timecategory.html every category with its two newest postsauthor.html every author with their four newest posts404.html shown for addresses that don't existstyle-guide.html every component with its name (noindex; delete it if you don't want it)blog/*.html one page per post (64)category/*.html one page per category (8)author/*.html one page per author (6)legal/*.html terms-of-service.html, privacy-policy.htmlassets/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 endpointassets/images/ photos, the logo, the sample ad's logoassets/fonts/ Intericon.svg, apple-icon.png, opengraph-image.pngsitemap.xml, robots.txtsrc/css/style.css the stylesheet's source: colours, breakpoints, the fontPages and sections 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. Ampersands are written &, and the demo uses the typographic ’; typing ' works too. When you search for
a sentence, search for a part without them.
Menu links and some labels roll up on hover: they are written twice, the second copy in Grey for the hover
(<span>Authors</span><span class="text-grey">Authors</span>). Change both.
The slideshows (Home’s hero and Inspiration) loop without end, so each holds copies of its slides before and after them
(inert, aria-hidden="true"). Change a slide in every copy: search the file for its title.
Text that repeats on every page
Section titled “Text that repeats on every page”The header, the footer, the sidebar, the newsletter band, your links and your contact details are copied into many
pages. Change them once for all files with your editor’s Find in Files / Replace in Files (VS Code:
Ctrl/Cmd + Shift + H). Include the .html, .xml and .txt files:
| Replace | With |
|---|---|
https://kendi-html-templategum.vercel.app |
Your domain, e.g. https://www.yourmagazine.com (canonical links, share cards, sitemap.xml, robots.txt) |
hello@kendi.com |
Your e-mail (Contact) |
+123-456-7890 (shown and in tel:+123-456-7890) |
Your phone (Contact) |
123 Editorial Street Creative District, City, Country and the business hours |
Your address and hours (Contact) |
https://x.com/, https://instagram.com/, https://facebook.com/ |
Your profiles (the sidebar, the footer, Contact, the authors, the footer’s photo grid) |
| The footer’s line about the magazine and the copyright | Yours; keep the <span data-current-year> in the copyright, which writes the current year |
| The sidebar’s About text (“We influence 20 million users…”) | Yours (Home and every post) |
| Kendi in <title> and share tags |
| Your Magazine (the Home title and long titles have no suffix) |
content="Kendi" |
Your site’s name (application-name and og:site_name) |
The share image’s description in og:image:alt |
A description of your share image |
Review each change before replacing all: “Kendi” also appears in the copy of About and Contact and the page descriptions, which you may want to rewrite rather than replace.
Blocks that repeat on several pages
Section titled “Blocks that repeat on several pages”Some blocks are copied into several pages. Change them in every copy (find and replace in files works for text):
| Block | Pages |
|---|---|
| The header (with the Categories menu and its Spotlight posts) and the footer (with the first five categories and the photo grid) | Every page |
| The newsletter band (title, text, the form, three photos of the newest posts) | Every page but the legal pages and the 404 |
| The sidebar (About, Explore Topics, the newsletter card, Spotlight, the ad) | index.html and every page in blog/ |
| The sponsored ad | index.html (wide, after Editor’s pick) and every sidebar (tall) |
| The breadcrumb | Every page but Home and the 404 |
| A post’s card | Every list that shows the post (adding a post) |
Images
Section titled “Images”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 1600 × 1067).
To use a new file instead, change the src: <img src="assets/images/my-photo.jpg" …>. In pages inside a folder
(blog/…, category/…, author/…, legal/…), 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. Frames that follow the screen change shape between phone, tablet and desktop (a post
cover is wide on a card and tall on a hero slide), so keep the subject away from the edges. Use photos at least as large
as the demo’s:
| Photos | Files | Demo size |
|---|---|---|
| A post’s cover (its cards, the hero slides, its page, the share image) | post-<first words of the slug>.jpg |
1600 × 1067 (3 : 2) |
| A category’s photo (tiles, the menu, its page) | category-<slug>.jpg |
400 × 400 |
| An author’s photo | author-<slug>.jpg |
400 × 400 |
| A team member (About) | team-<name>.jpg |
400 × 600 |
| The three photos of About | about-1.jpg, about-2.jpg, about-3.jpg |
1200 × 1800 and two 800 × 533 |
| The footer’s photo grid | instagram-1.jpg to -4.jpg |
400 × 400 |
| The sample ad | ad-tenq-tech.jpg, ad-tenq-tech-logo.svg |
1200 × 900, and an SVG logo |
A post’s cover is used in every card of the post, its page and its share image; replacing the file changes every place.
Use .jpg for photos and keep files small; compress them with Squoosh or
TinyPNG. Write an alt text for images that carry meaning.
Pages link to each other as about.html, blog/<slug>.html, category/<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. 404.html is the
exception: its links start at the site’s root (/contact.html), because hosts show it at any address.
Three demo posts have a typographic ’ in their file name: links write it encoded (%E2%80%99). Use plain letters,
digits and - in the names of your own pages.
The sponsored ad
Section titled “The sponsored ad”Home shows an ad after Editor’s pick (a wide card) and every sidebar ends with one (a tall card, with the logo and no
name). The sample advertiser, Tenq Tech, is made up, and its “Learn more” button leads to your own Contact page, so the
slot works as an “advertise with us” placeholder. Replace it with your own ad — a sponsor, your own product, your
newsletter: its photo, logo, name, text and the button’s link (search the folder for “Tenq”). The button also carries
<span class="sr-only"> about Tenq Tech</span>: hidden on screen, read by screen readers and search engines after
“Learn more” — put your advertiser’s name there. To remove it, delete the
ad’s block (from its “- Sponsored Ad -” label to the end of its card) on Home and in every sidebar.
Adding a post
Section titled “Adding a post”A post is a page plus its card in the lists. The lists are written out in the HTML and keep their order, so put a new card where its date belongs (newest first):
-
The page. Copy a page in
blog/→blog/my-new-post.html. Use lower-case words joined by-for the file name; it becomes the address. Edit:- the breadcrumb (its category and its title), the category pill, the title, the excerpt, the author and the date
(the
<time>element’sdatetimeand its text,Mar 12, 2026), the cover and the text; - “Related Post”: the newest other posts of its category;
- the
<head>: title, description, canonical,og:url, the post’s date inarticle:published_timeand its cover asog:imageandtwitter:image.
The text is plain HTML: paragraphs
<p>, headings<h2>and<h3>, lists,<strong>for bold,<em>for italics and links. Copy a block of the kind you need from the page, with its classes. - the breadcrumb (its category and its title), the category pill, the title, the excerpt, the author and the date
(the
-
Articles. Copy a card in
blog.htmland put it in date order. The first six cards are shown at once; the others carrydata-later class="hidden"and appear as the reader scrolls. When the new card takes one of the first six places, the sixth card moves down: give itdata-later class="hidden"and remove them from the new one. -
Its category and its author. Add the card to
category/<slug>.htmlandauthor/<slug>.html, and to the previews ofcategory.html(the two newest of each category) andauthor.html(the four newest of each author). -
Home and the shared blocks, when the post is among the newest: the hero slideshow (the five newest) and the list beside it, Latest posts, the sidebar’s Spotlight (the four newest, on Home and every post) and the newsletter band’s three photos (every page). Editor’s pick and Trending show the posts you choose, Inspiration the newest post of each category: add the card there if you want it.
-
The sitemap. Add a line to
sitemap.xml:<url><loc>https://yourdomain.com/blog/my-new-post.html</loc></url>
To remove a post, do the reverse: delete the page, its cards, any link to it and its line in sitemap.xml. Search the
folder for the file name to catch every card left behind.
A magazine that publishes often is easier to run with the Astro or Next.js edition, which builds every list from one collection: one entry per post (Editing without touching HTML).
Categories, authors and the team
Section titled “Categories, authors and the team”- A category is a page (
category/<slug>.html: its name, description, photo and every post), a tile oncategory.html, an entry in the Categories menu and the footer (the first five), and in the sidebar’s Explore Topics (the first six); each post card carries its category’s pill. Copy a category page for a new one and add its tile, then the links where you want it. - An author is a page (
author/<slug>.html: photo, name, role, bio, social links and every post) and an entry onauthor.html; every card names its author with a link. - The team on About (“Meet the Team”) is six cards in
about.html; team members have no pages.
Add each new page to sitemap.xml.
Legal pages
Section titled “Legal pages”legal/terms-of-service.html and legal/privacy-policy.html hold a title, “Last updated: “ with its date and the text.
Their text is a generic sample with placeholders in square brackets — [Your Company Name], [URL],
[Contact Information], [Your Jurisdiction], [Arbitration Location], [Link to Privacy Policy] — and is not ready
to publish. Replace every placeholder (search the files for [), make the texts say what your site really does (the
newsletter, the contact form, the form service you use, any analytics) and have them checked for the law where you
publish. The footer of every page and the newsletter’s consent line link them.
Adding a page
Section titled “Adding a page”- Copy a page close to what you want, e.g.
contact.html→advertise.html. - Replace the sections inside
<main>with the ones you want. Every section in the template is a block you can copy from its page (or fromstyle-guide.html) and paste between<main>and</main>. The header keeps a spacer of its height, so the first section needs no extra space. - Update the
<head>(title, description, canonical,og:url, and theog:andtwitter:titles and descriptions) and the breadcrumb. - If you copied a page of the menu, the copy marks that page as the current one (
aria-current="page"): remove it. - Link to it from the header’s menus or the footer’s Navigation column, in every page (pages in
blog/,category/,author/andlegal/write../before each link, and404.htmlwrites its links from the root). Add the page tositemap.xml.
Removing a page
Section titled “Removing a page”Delete the file, remove its links from the menus and the footer of every page and its line from sitemap.xml. Search
the folder for the file name to catch any link left behind: buttons link to pages too (“Contact us” and the ad’s “Learn
more” to Contact, “More categories” to Categories, “View more” to Articles).
The style guide
Section titled “The style guide”style-guide.html shows every component with its name, which is handy for copying a button or a card. It’s hidden from
search engines and linked from nowhere. Delete it before publishing if you don’t want it online.