Skip to content
Sign inJoin waitlist

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.

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:

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, about.html, contact.html
blog.html Articles: every post, six at a time
category.html every category with its two newest posts
author.html every author with their four newest posts
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)
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.html
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, the sample ad's logo
assets/fonts/ Inter
icon.svg, apple-icon.png, opengraph-image.png
sitemap.xml, robots.txt
src/css/style.css the stylesheet's source: colours, breakpoints, the font

Pages 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.

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.

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)

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.

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.

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):

  1. 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’s datetime and 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 in article:published_time and its cover as og:image and twitter: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.

  2. Articles. Copy a card in blog.html and put it in date order. The first six cards are shown at once; the others carry data-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 it data-later class="hidden" and remove them from the new one.

  3. Its category and its author. Add the card to category/<slug>.html and author/<slug>.html, and to the previews of category.html (the two newest of each category) and author.html (the four newest of each author).

  4. 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.

  5. 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).

  • A category is a page (category/<slug>.html: its name, description, photo and every post), a tile on category.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 on author.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/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.

  1. Copy a page close to what you want, e.g. contact.html → advertise.html.
  2. 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 from style-guide.html) and paste between <main> and </main>. The header keeps a spacer of its height, so the first section needs no extra space.
  3. Update the <head> (title, description, canonical, og:url, and the og: and twitter: titles and descriptions) and the breadcrumb.
  4. If you copied a page of the menu, the copy marks that page as the current one (aria-current="page"): remove it.
  5. Link to it from the header’s menus or the footer’s Navigation column, in every page (pages in blog/, category/, author/ and legal/ write ../ before each link, and 404.html writes its links from the root). Add the page to sitemap.xml.

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).

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.