Lipi

Lipi is an open-source Astro template for typography-first long-form publishing, turning Markdown and MDX files into a static publication site for essays, travel notes, developer journals, and personal archives.

What is Lipi?

Lipi is a publishing template built on Astro that renders Markdown and MDX content from src/content/posts into a static HTML site with a reading-focused design. It takes a single configuration file, configs/lipi.config.ts, and a content folder as input, and produces a fully static site with RSS feed, sitemap, full-text search, and auto-generated OG images. It is created by The Localhost Studio and released under the MIT license. The word "Lipi" (लिपि) is Sanskrit for "script," reflecting the template's emphasis on the written word.

Key Features

• Typography system — Literata for body text, Manrope for UI, Fira Code for code, and Caveat for annotations, all loaded through Fontsource.
• Static full-text search — Pagefind builds a search index at build time with no external API, no tracking, and no client-side database.
• Auto-generated OG images — Per-post social sharing images are generated with Satori, so writers never need to create cover images manually.
• CSS-only theming — Light and dark themes switch via CSS custom properties without JavaScript, and the warm neutral palette plus one brand accent are customized in src/styles/theme.css.
• Timeline archive — Posts are grouped chronologically by year, and subdirectories prefixed with an underscore are stripped from URLs for clean slugs.
• Taxonomy and related posts — Frontmatter tags generate tag pages and drive related-post suggestions on each article.
• Shiki syntax highlighting — Code blocks are highlighted with light/dark token mapping, and the template supports both GitHub-Flavored Markdown and MDX.
• Print-aware layout — Paper texture and print styles keep the reading layout intact when using the browser's print command.

Who is Lipi for?

Lipi is for writers who publish chronologically and want a calm, publication-like site without web-app complexity. It suits essayists who want a constrained reading measure (68 characters per line), developers who want clean code rendering in a personal journal, and travel or personal archivists who need year-based organization and tag filtering. It is not a good fit for sites that require sidebars, comment sections, newsletter embeds, or dashboards.

What can you do with Lipi?

• Essayists and long-form writers — publish chronological essays with a terracotta accent, generous line-height, and print-friendly output.
• Developer journal keepers — write MDX posts with Shiki-highlighted code, then generate a static search index and RSS feed with one build command.
• Personal archivists — organize notes in year-based subfolders that disappear from URLs, then let the timeline archive group everything by year.
• Design-conscious publishers — change all colors in one CSS file, swap fonts in astro.config.mjs, and pick a "default" or "studio" hero variant from the config.

How does Lipi work?

Scaffold a project with npm create astro@latest -- --template thelocalhoststudio/lipi or clone the repository, then run npm install and npm run dev. Add posts as Markdown or MDX files in src/content/posts/, edit all site settings in configs/lipi.config.ts, and run npm run build to output a static site to ./dist/ with a Pagefind search index.

Pros and cons

• Pro: Static output with minimal client-side JavaScript; search, RSS, and sitemap are generated at build time.
• Pro: Highly customizable palette and type scale through CSS custom properties and a single config file.
• Con: Deliberately omits sidebars, comment sections, newsletter embeds, and dashboards, so it is not a general-purpose blog theme.

Pricing

Lipi is free and open-source under the MIT license, so it can be used for personal or commercial projects with attribution to The Localhost Studio in the credits.

FAQ

Is Lipi free?

Yes, Lipi is open-source under the MIT license. You can use, modify, and deploy it freely, and the source code is available on GitHub.

Does Lipi support tags?

Yes. Each post can include a tags array in its frontmatter. The template uses these tags to generate tag pages and to surface related posts on each article.

Can I customize colors and fonts?

Colors are defined as CSS custom properties in src/styles/theme.css — a warm neutral scale from --base-50 to --base-950 plus a --brand accent. Fonts are configured in astro.config.mjs under the fonts array, and any name can be swapped to a Fontsource typeface.

Does Lipi have a comment section?

No. Lipi is intentionally designed without sidebars, comment sections, newsletter embeds, or dashboards. It focuses on a clean reading experience for publication-style sites.

What content formats are supported?

Lipi supports GitHub-Flavored Markdown and MDX for posts and pages. Posts live in src/content/posts/ and pages in src/content/pages/, with optional frontmatter fields such as draft, lang, cover, and updated.