Astro Sarissa Blog Theme is a responsive, Markdown-based personal blog theme built on the Astro framework, providing a fully functional blog site with category and archive views, fuzzy search, and three color modes.
What is Astro Sarissa Blog Theme?
Astro Sarissa Blog Theme is a free, MIT-licensed Astro starter for personal blogs that takes Markdown posts as content and outputs a static, responsive blog website. Created by İsmail Özçelik, the theme is configured through a single JavaScript config object that controls site title, description, social media links, categories, date format, pagination size, search options, and UI labels. It runs on the Astro static site generator, so the final build is plain HTML, CSS, and JavaScript with no server required.
Key Features
- Markdown-based blogging — Write posts in Markdown and the theme renders them into a structured blog with home, category, archive, about, and search pages.
- Three color modes — Light, Book, and Dark themes can be toggled by readers using the included theme-change component.
- Built-in fuzzy search — Fuse.js powers title and description search with configurable weights and scoring, accessed from a dedicated search page.
- Category system — Define categories with custom colors, images, ordering, and post counts; categories display as either buttons or cards.
- Archive and pagination — Posts are paginated on the home page, category pages, and archive view, with a year selector for browsing older content.
- Easy site configuration — All site settings live in one config object: siteTitle, siteDescription, favicon, footer, dateFormat, socialMedia, pageSize, categories, categorySettings, searchOptions, menu, and i18n labels.
- Responsive and functional — The layout adapts to mobile and desktop, and the sidebar shows site info, social links, categories, and recent archive years.
- Tech stack — Uses Tailwind CSS for styling, DaisyUI for pre-built components, Luxon for date formatting, and theme-change for color mode switching.
Who is it for?
- Personal bloggers who want a self-hosted, Markdown-based blog without a database or CMS.
- Astro developers looking for a ready-made starter to customize and extend.
- Technical writers who prefer writing in Markdown and need search and categorization to organize posts.
What can you do with Astro Sarissa Blog Theme?
- Publish a personal blog — Write Markdown files, add categories, and the theme generates a complete blog with pagination, search, and archives.
- Customize the design — Change the site title, description, footer, date format, social media links, and category colors directly from the config object.
- Localize labels — Use the i18n object to translate menu items, search placeholder, archive selector, and pagination text.
How does it work?
After cloning the Astro project, edit the config file to set site information, categories, and preferences, then add Markdown posts to the content directory. The theme builds the static site with Astro, and the result is deployable to any static host like GitHub Pages, Netlify, or Vercel.
Pricing
The theme is free and MIT licensed, so it can be used commercially or personally, modified, and redistributed with attribution to the original creator.
Alternatives
- AstroPaper — another MIT-licensed Astro blog theme with a similar minimal Markdown-based approach.
FAQ
Is Astro Sarissa Blog Theme free?
Yes. The theme is released under the MIT license, so it is free to use, modify, and distribute, including for commercial projects.
Does the theme support dark mode?
Yes. Sarissa Blog includes three color modes — Light, Book, and Dark — that readers can switch between via the theme-change component.
Can I customize the site configuration?
Yes. The theme centralizes configuration in a single object where you can set the site title, description, favicon, footer, date format, social media links, default page size, categories, search options, menu labels, and i18n translations.
Does the theme include search?
Yes. It uses Fuse.js to provide fuzzy search that matches post titles and descriptions, with configurable key weights and scoring.
