Astro Flexoki

Astro Flexoki

Astro Flexoki is a minimalist blog theme for Astro that combines Tailwind CSS with the Flexoki color palette to produce fast, SEO-friendly static sites.

What is Astro Flexoki?

Astro Flexoki is an open-source blog theme built on the Astro static site generator, styled with Tailwind CSS, and colored with the Flexoki palette by Steph Ango. It takes Markdown content from the src/content folder and outputs a fully static website, with a configurable global site file at site.config.ts. The theme is authored by Amit K (GitHub: ak0r) and released under the MIT license.

Key Features

• Static site generation with Astro — Outputs pre-built HTML for fast loads, with no JavaScript by default.
• Flexoki color palette — Uses the warm, harmonious color tokens from Steph Ango's Flexoki scheme, with support for an accent color setting.
• Light/dark mode toggle — Switches between themes using the data-theme attribute, with dark mode enabled by default.
• SEO optimization — Dynamic <meta> tags and Open Graph support are built in, and the theme is ready for OG image generation via the Astro API (still in progress).
• Markdown-powered content — Blog posts, notes, and pages are written in Markdown and organized in content collections.
• Responsive, mobile-first design — Layouts adapt to small screens without extra configuration.
• Configurable links — Navigation, social, and footer links are all edited in the central site.config.ts.
• No heavy dependencies — Only Astro and Tailwind CSS are required, keeping the install lightweight.

Who is it for?

Astro Flexoki fits developers who want a clean, fast blog without a heavy framework. Writers who publish via Markdown can use it to maintain a personal site. Design-minded creators who appreciate the Flexoki palette can customize the theme's accent colors and light/dark modes. The simple structure also suits anyone learning Astro, since the folder layout and configuration are straightforward.

What can you do with Astro Flexoki?

• Start a personal blog — Publish Markdown posts and pages, with the settings for posts per page and newsletter signup available in site.config.ts.
• Create a portfolio or notes site — The roadmap includes adding Projects and Notes content collections, but the existing markdown pages support this use case already.
• Learn Astro and Tailwind — The minimal codebase and clear folder structure make it a useful reference for static-site workflows.

How does Astro Flexoki work?

To get started, clone the repository from https://github.com/ak0r/astro-flexoki.git, install dependencies with npm install, and run npm run dev to view the site at http://localhost:4321. All global settings — site title, description, author, accent color, posts per page, dark mode, and newsletter signup — live in the site.config.ts file, which you can edit before building for production.

Pros and cons

Pros: fast Astro-based static output; customizable Flexoki theme with light/dark modes; free MIT license; no heavy dependencies. Cons: some planned features like full-text search, RSS feed, and sitemap are not yet implemented; OG image generation is listed as in progress.

Pricing

Astro Flexoki is free to use, modify, and share under the MIT license, as stated in the repository.

Alternatives

Astro Pure — an Astro theme referenced as a source of inspiration for this template.

FAQ

Is Astro Flexoki free?

Yes, the theme is licensed under the MIT license, so you can use, modify, and share it without cost. The repository is public on GitHub.

How do I customize the theme?

Edit site.config.ts to change the title, description, author, URL, accent color, posts per page, dark mode toggle, and newsletter signup setting. Tailwind and theme styles are in the styles folder.

Does it support Markdown?

Yes, blog posts, notes, and pages are written in Markdown and placed in the src/content folder. The theme processes them with Astro's content collections.

What features are still missing?

The roadmap lists full-text search, Projects/Notes content collections, OG image generation, CMS integration, and RSS feed/sitemap as future work. Currently it includes posts, pages, and a working blog layout.

Can I use my own color palette?

The theme is built around Flexoki, but you can change the accent color in site.config.ts and adjust Tailwind styles in tailwind.config.ts to achieve a different look.