arthelokyo/astrowind

★ 5,654AstroAudience · vibe coderComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((AstroWind))
    Performance
      PageSpeed optimized
      Image optimization
      Static output
    SEO Features
      Auto sitemap
      Social metadata
      RSS feed
    Blog System
      Markdown MDX
      Tags categories
      Related posts
    Configuration
      Single YAML file
      JS navigation file
      Analytics support
    Deployment
      Any static host
      One command setup
      Framework agnostic

mindmap root((AstroWind)) Performance PageSpeed optimized Image optimization Static output SEO Features Auto sitemap Social metadata RSS feed Blog System Markdown MDX Tags categories Related posts Configuration Single YAML file JS navigation file Analytics support Deployment Any static host One command setup Framework agnostic

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Build a personal portfolio or blog site with minimal setup

USE CASE 2

Launch a business landing page with built-in SEO and performance

USE CASE 3

Create a content blog with tags, categories, and RSS subscription support

USE CASE 4

Use as a starter template and layer in React, Vue, or Svelte as needed

Tech stack

AstroTailwind CSSMarkdownMDXYAMLJavaScriptGoogle AnalyticsSplitbee

Getting it running

Difficulty · easy Time to first run · 30min

One command scaffolds the project. Set site details in a single YAML file. Run local dev server immediately. Deploy to any static host with no special configuration.

Free and open-source. You can use, modify, and distribute this template freely.

In plain English

AstroWind is a free, open-source website template built with Astro and Tailwind CSS. Astro is a framework for building fast, mostly static websites, and Tailwind CSS is a styling system that lets developers describe the appearance of elements directly in the HTML. AstroWind combines the two into a starting point for personal sites, blogs, or business pages, and has been the most starred Astro theme on GitHub each year from 2022 through 2025 according to the README. The template is set up to produce high-performance sites from the start. It scores well in Google PageSpeed tests, which measure how quickly a page loads and how stable the layout is while loading. SEO features are included by default: a sitemap is generated automatically from the site's pages, blog posts can be tagged and categorized, social sharing metadata is added to each page, and an RSS feed is created so readers can subscribe. Images are optimized through Astro's asset system, which resizes and compresses them at build time rather than serving oversized files. The blog system supports Markdown and MDX files, which are plain text files with formatting codes, similar to writing in a simple text editor. Posts are placed in a specific folder and become pages automatically based on their filename. Categories, tags, social share buttons, and related post links are handled by the template. Google Analytics and a service called Splitbee can be connected for tracking visitor statistics. Configuration is done through a single YAML file at the top of the project, where you set the site name, URL, SEO defaults, social accounts, and blog settings. Navigation is defined in a separate JavaScript file. The template does not impose a JavaScript framework, so developers can add React, Vue, Svelte, or any other library on top of the base. To start a new project from the template, a single command creates the project structure. Local development, build, and preview commands are provided. The template can be deployed to any static hosting service.

Copy-paste prompts

Prompt 1

I'm using the AstroWind template (Astro + Tailwind CSS). Help me customize the YAML config file to set up my site name, URL, social accounts, and SEO defaults for a personal portfolio.

Prompt 2

I have an AstroWind blog site. How do I add a new MDX blog post with tags, a category, and a social share image so it appears automatically as a new page?

Prompt 3

I'm building on AstroWind and want to add a React component to one of my Astro pages. Walk me through how to install React and drop a component into an existing page.

Prompt 4

Help me deploy my AstroWind site to Cloudflare Pages. What build command and output directory should I configure, and are there any gotchas to watch for?

Prompt 5

I want to connect Google Analytics to my AstroWind site. Where do I add my tracking ID and what does the configuration look like?

Open on GitHub → Explain another repo

← arthelokyo on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.