Back to themes

The Headless Journal

A free, open-source editorial blog starter built with Astro 7, Tailwind CSS 4, and TypeScript. Features a responsive design, static content, and optional headless WordPress integration through RKX API Studio.


Cost

Free


The Headless Journal is a free, open-source editorial blog starter built with Astro 7, Tailwind CSS 4, and TypeScript.

Designed for modern content-driven websites, it combines a clean editorial interface with fast static site generation and a flexible content architecture.

Features

  • Modern, responsive editorial design
  • Eight sample articles with illustrations
  • Article pages with author information and categories
  • Category archives and paginated blog listings
  • RSS feed and XML sitemap
  • SEO-friendly metadata and canonical URLs
  • Open Graph metadata
  • Accessible navigation and semantic HTML
  • Zero client-side JavaScript required for the demo
  • MIT licensed and fully open source

Three Content Modes

The starter uses a typed content adapter that supports three configurations:

Demo Mode: Run the complete website using bundled JSON content. No WordPress installation, database, API credentials, or external services are required.

Free Mode: Connect to a headless WordPress installation using RKX API Studio Free and consume structured REST API content.

Pro Mode: Extend the integration with RKX API Studio Pro, including dynamic API routes and custom field mapping.

Built for Developers

The project includes TypeScript, reusable Astro components, Tailwind CSS styling, sample content, and documentation to help developers customize and extend the starter.

The demo runs as a fully static website and can be deployed to static hosting platforms such as Cloudflare Pages.

Performance

The production demo has achieved 100/100 Lighthouse scores across Performance, Accessibility, Best Practices, and SEO in laboratory testing.

Getting Started

Clone the public GitHub repository, install dependencies using Node.js 22.23.4 or later, and run the development server. Demo Mode works immediately without a backend.

Explore the live demo or visit the GitHub repository for installation instructions and source code.