Skip to content
Sign inJoin waitlist

Going live — Kendi Astro

Before the Kendi site goes public, replace the demo’s magazine with yours, fill in the legal pages and point the forms at you; then build it and put it on any static host, and check it again.

Replacing the demo’s magazine means its name, contact details, posts, authors, team, photos and the sample ad; pointing the forms at you means giving the newsletter and the contact form a destination. Once the site is deployed, click through the live address once more.

Where
Your domain in site.url (until you change it, it is the demo’s address) src/content/site.json. Share links, sitemap.xml and robots.txt are built from it.
Name, title and description (they describe the template: write yours) site in src/content/site.json; the share image’s description, shareImage.alt, in src/lib/meta.ts
Your magazine’s name instead of “Kendi”: the copyright, About, Contact, the page titles and descriptions Search src/content/ (Editing the content)
Contact details: the e-mail, phone, address and hours are made up contact in src/content/site.json
Social links (they open the networks’ home pages), the authors’ links and the footer grid’s links socials in src/content/site.json, authors.json, instagram.json
The sidebar’s About text (“We influence 20 million users…” is the demo’s claim) sidebar.about in src/content/site.json
The legal pages: every placeholder filled in ([Your Company Name], [URL], [Contact Information], [Your Jurisdiction], [Arbitration Location], [Link to Privacy Policy]) and the texts checked for your site src/content/collections/legal.json (Editing the content)
The sponsored ad replaced with your own, or removed (Tenq Tech is a made-up advertiser) sponsoredAd in src/content/site.json (Editing the content)
Your posts, categories and authors src/content/collections/
Your team on About src/content/collections/team.json
Logo replaced src/assets/images/logo.svg (Making it look like your brand)
Browser icons replaced public/icon.svg, public/apple-icon.png
Share image replaced and described public/opengraph-image.png, its description in src/lib/meta.ts
Demo photos replaced src/assets/images/
Page titles and descriptions written for your site The meta of each file in src/content/pages/
The forms deliver to you Forms
Style guide kept or deleted src/pages/style-guide.astro
npm run check and npm run build pass, and npm run preview looks right —

The demo content is there to be replaced. Leaving “Kendi”, the sample e-mail and phone, the demo posts and authors, the sample ad or the legal placeholders on a live site is the most common mistake.

npm run build writes a complete static site to dist/: HTML files, one stylesheet, a few small scripts, the font file and optimised images. Any host that serves files can run it, with no Node.js needed on the server (unless you chose server-mode forms).

Vercel, Netlify or Cloudflare Pages (free for most sites)

Section titled “Vercel, Netlify or Cloudflare Pages (free for most sites)”
  1. Push the project to GitHub, GitLab or Bitbucket.
  2. Import the repository. Astro is detected: build command npm run build, output folder dist.
  3. Add your form variables (PUBLIC_FORM_ENDPOINT, …) in the host’s environment settings, then deploy.
  4. Add your domain in the host’s Domains settings and follow the DNS instructions.

Pages are built as files (about.html, blog/<slug>.html) and served at clean addresses (/about). Netlify and Cloudflare Pages do that by default; on Vercel, the included vercel.json sets "cleanUrls": true (it also turns off Vercel’s automatic deployments from Git: remove "git": { "deploymentEnabled": false } if you want them).

Any other host (shared hosting, S3, a VPS)

Section titled “Any other host (shared hosting, S3, a VPS)”
Terminal window
npm run build

Upload the contents of dist/ to the web root. For clean addresses, make the server try <path>.html:

  • Apache (.htaccess):

    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME}.html -f
    RewriteRule ^(.+)$ $1.html [L]
    ErrorDocument 404 /404.html
  • nginx: try_files $uri $uri.html $uri/ =404; and error_page 404 /404.html;

Three demo posts have a typographic ’ in their address: the links carry it encoded (%E2%80%99), and the file is written with the character itself. Common hosts map one to the other; check one of those posts after uploading.

If you set PUBLIC_FORM_MODE=server, add your host’s adapter first (npx astro add vercel, netlify, cloudflare or node). Only the form route runs on the server; every page stays static.

  1. Check the pages. Click through every page on a phone and a laptop:
    • the menu, the Categories menu on desktop, the tablet and phone menus;
    • the hero slideshow and the Inspiration carousel;
    • Articles loading more posts as you scroll;
    • a post with its sidebar and Related Post, a category page, an author page;
    • the ad’s button, the footer’s links and legal pages.
  2. Sign up and write to yourself on the live site — the newsletter from Home, the sidebar and the band, and a contact message — and reply to the message.
  3. Verify the share card. Paste the URL of the home page and of a post into https://www.opengraph.xyz or a chat window, and confirm the image and title.
  4. Tell Google. Add the site to Search Console, verify ownership and submit https://yourdomain.com/sitemap.xml. Bing has the same thing in Webmaster Tools.
  5. Analytics, if you want it. Add your snippet to the <head> in src/layouts/Layout.astro, or use your host’s built-in analytics (Vercel Analytics, Cloudflare Web Analytics, Plausible, Fathom). None of them need a cookie banner.
  6. Keep publishing. A new post is one entry in src/content/collections/posts.json (its date puts it in place); see Editing the content. Connect a CMS (Using a headless CMS) if writers who don’t use a code editor will publish.

The template ships with what search engines look for:

  • pre-rendered HTML, with links in it to every page — every post of Articles too, even the ones that load on scroll;
  • one <h1> per page, and a title and description for every page;
  • canonical links, sitemap.xml, robots.txt and share cards (posts as articles, with their date);
  • sized, lazy-loaded images that keep their space while they load.

Keeping the site fast is mostly about images. Export photos at the size they are shown, not the size your camera produced; the placeholders show the size each one was designed for.