AstroStarter

astro-swiss-free-starter-theme — Astro Starter Template

By vincentheimann

Astro Swiss free starter theme, built on Astro, with built-in i18n, dark mode, and Starwind UI components, under MIT license.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

2 previews
Desktop homepage1 / 2
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 2

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-09-30View source

What stands out

A quick read of the recorded project description.

01

Built-in Astro native i18n routing, preconfigured for French, German, and English

02

Uses Starwind UI component library, built on Tailwind CSS

03

Dark mode supports localStorage persistence and system preference detection

04

Content data organized in a typed manner with TypeScript, facilitating maintenance of team, services, portfolio, and other information

05

Provides AGENTS.md to explain theme structure and conventions to AI tools

06

MIT license, allowing free use, modification, commercial use, and distribution

Template Details

This is an Astro-based starter theme for building multilingual websites. It includes Astro's native i18n routing, preconfigured for French, German, and English, with an extensible architecture for adding more languages. UI components come from Starwind UI, built on Tailwind CSS, and include common blocks such as cards and hero sections. The theme implements dark mode with user preference persistence (localStorage) and system preference detection. The code is written in TypeScript, with content data (team, services, portfolio) organized in a typed manner under the src/data directory, translation dictionaries in src/i18n, and pages using file-based routing. The project structure follows standard Astro layout, with directories including components, data, i18n, layouts, and pages. The repository provides AGENTS.md to explain the theme structure and conventions to AI tools. The free version is a standalone complete version; the MIT license allows use, modification, commercial use, and distribution, but third-party assets such as demo images, fonts, and icons require separate license verification; the paid version and its features mentioned in the materials are not included in this listing.

AstroStarter

Is it right for your project?

Use Cases

  • Building corporate or product sites that require multilingual support
  • Quickly starting an Astro project with ready-made components and layouts
  • Showcase websites that switch between dark and light modes
  • As a reference project for learning Astro i18n routing and component organization

Suitable For

  • Front-end developers familiar with Astro and Tailwind CSS
  • Website projects that need multilingual infrastructure
  • Teams that want to freely modify and distribute code under the MIT license

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    After cloning the repository, run npm install to install dependencies, then run npm run dev to start the development server

  2. 2

    The default development address is http://localhost:4321

  3. 3

    To add a new language, refer to the Adding Languages guide in the official documentation

  4. 4

    Third-party assets such as demo images, fonts, and icons require separate license verification according to their respective licenses

  5. 5

    The paid version and commercial license mentioned in the materials are not included in the free version

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This listing covers the free version under the MIT license in the public repository; the free scope applies to that version's code and does not imply that external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version's code are allowed.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • The paid premium version offers an AI agent workspace and one-click deterministic configuration, and includes a commercial license and major version updates; these features are not part of the free version, and the free version does not include a commercial license.
  • The commercial license and major version updates are only provided with the paid premium version; the free version does not include a commercial license, and commercial use requires independently confirming the license scope.
  • The project materials mention optional paid versions or features; this listing only covers the public free code and does not include paid upgrades.
  • Demo images, fonts, icons, and other third-party assets require license verification according to their respective licenses and cannot be judged solely based on the code's MIT license.
  • External services such as domain, hosting, database, payment, or AI may incur additional charges.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

The [Premium Version](https://astroswiss.com) ships an agent workspace with a one-command deterministic setup

Original README

plus a commercial license and all updates to your major version included

Original README
https://github.com/vincentheimann/astro-swiss-free-starter-theme/blob/main/LICENSEhttps://github.com/vincentheimann/astro-swiss-free-starter-theme/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-01. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
More documented · 83 / 100
Technologies
Astro
Website type
Starter
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2026-09-28
Screenshot last checked
2026-10-01

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Astro as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: 755f5448016fa6fe054a714524b9daab187b93b187d7388cfb1ef25e26e68421

2026-10-01T13:41:52.456Z

Source file / repository
# Astro Swiss Free Starter Theme

**A professional, multilingual foundation for proper Astro projects.**

[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![Changelog](https://img.shields.io/badge/changelog-keep--a--changelog-orange.svg)](CHANGELOG.md)

[**🌐 Live Demo**](https://demo.astroswiss.com) | [**📖 Documentation**](https://docs.astroswiss.com) | [**💼 Premium Version**](https://astroswiss.com)

---

> [!NOTE]
> **Production Ready**: This free version is a complete, standalone product with **Astro 7**, **Tailwind 4**, and **i18n** built-in. It is not a "lite" version with broken features.
>
> *Want your AI agent to do the work?* The [Premium Version](https://astroswiss.com) ships an agent workspace with a one-command deterministic setup — verified with real setup runs in Claude Code, Cursor and Antigravity, built for any tool that reads AGENTS.md. Describe your company and get your configured site in one conversation — plus a commercial license and all updates to your major version included. **Buy once. Your agent does the rest.**
>
> This free theme is agent-friendly too: its `AGENTS.md` teaches your AI tool the theme's structure and conventions.

## 🚀 Quick Start

Get your site running in less than 2 minutes.

```bash
# 1. Clone the repository
git clone https://github.com/vincentheimann/astro-swiss-free-starter-theme.git
cd astro-swiss-free-starter-theme

# 2. Install dependencies
npm install

# 3. Start development server
npm run dev
```

Visit **[http://localhost:4321](http://localhost:4321)** to see your new site.

---

## ✨ Features

Built to modern web standards, focusing on performance and developer experience.

- **🌍 True Multilingual (i18n)**: Native Astro i18n routing with French, German & English pre-configured. Scalable architecture for adding more languages.
- **🎨 Starwind UI System**: A collection of beautiful, accessible components built on **Tailwind CSS v4**.
- **⚡ Exceptional Performance**: Fast, lightweight pages. Minimal JavaScript — only where interaction needs it.
- **🌓 Dark Mode**: Robust implementation with user preference persistence (localStorage) and system preference detection.
- **🛡️ Type-Safe**: Written in TypeScript for a confident development experience.

---

## 📚 Documentation

Detailed guides to help you customize and deploy.

### 🏁 User Guides
- [**Getting Started**](https://docs.astroswiss.com/getting-started/): The quick setup guide — running in less than 2 minutes.
- [**Data & Content**](https://docs.astroswiss.com/guides/data-management/): How to manage your team, portfolio, and services data.
- [**Styling**](https://docs.astroswiss.com/guides/styling/): Customizing the design system and branding.
- [**Deployment**](https://docs.astroswiss.com/deployment/): Production checklist and deployment guides.

### 🛠️ Developer Resources
- [**Adding Languages**](https://docs.astroswiss.com/guides/adding-languages/): Expanding to 3+ languages.
- [**Configuration**](https://docs.astroswiss.com/guides/configuration/): Advanced configuration options.

---

<details>
<summary><strong>📂 Project Structure</strong></summary>

We use a standard, intuitive Astro structure:

```text
astro-swiss-free-starter-theme/
├── src/
│   ├── components/    # Starwind UI components (Cards, Heroes, etc.)
│   ├── data/          # Type-safe content (Team, Services, Portfolio)
│   ├── i18n/          # Translation dictionaries
│   ├── layouts/       # Main layouts (Head, Metadata)
│   └── pages/         # File-based routing
├── public/            # Static assets
└── astro.config.mjs   # Astro configuration
```

</details>

<details>
<summary><strong>📦 Tech Stack</strong></summary>

- **Astro 7**
- **Tailwind CSS 4**
- **Starwind UI**
- **TypeScript**
- **Embla Carousel**
- **Tabler Icons**

</details>

---

## 🤝 Support

We are committed to maintaining a high-quality open source foundation.

- **Documentation**: [docs.astroswiss.com](https://docs.astroswiss.com)
- **Issues**: [GitHub Issues](https://github.com/vincentheimann/astro-swiss-free-starter-theme/issues)
- **Purchase & licensing questions**: [[email protected]](mailto:[email protected])

Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.