astro-swiss-free-starter-theme — Astro 启动器模板

SHA-256: 755f5448016fa6fe054a714524b9daab187b93b187d7388cfb1ef25e26e68421

2026-10-01T13:41:52.456Z

# 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])