Astro i18n Starter is an open-source starter template for building multilingual static websites with Astro's official i18n routing, published by psephopaiktes and available on GitHub. It handles the core task of organizing content per language and generating localized URLs in the subdirectory format, making it a minimal base for any project that needs multiple language versions.
What is Astro i18n Starter?
Astro i18n Starter is a minimal Astro theme designed for creating multilingual websites. It leverages the i18n routing introduced in Astro v4.0, managing each language under a URL prefix such as example.com/en/ or example.com/ja/, with the root URL redirecting to the configured default language. The template takes your page content organized by locale and produces a static site with SEO-friendly localized URLs, running on any platform that supports static builds.
Key Features
- Official Astro i18n support — Uses Astro v4.0's built-in internationalization routing rather than a third-party plugin, staying aligned with the core framework's conventions.
- Subdirectory URL scheme — Each language is served from a distinct subfolder like /en/ and /ja/, and the root path automatically redirects to the specified default language, simplifying canonical URL management.
- Vanilla CSS — Styling is done with plain CSS, so no Tailwind, Bootstrap, or other CSS framework is required out of the box, keeping the template light and easy to customize.
- SEO-friendly structure — Includes metadata and semantic HTML designed to help search engines index localized pages correctly, a key requirement for multilingual sites.
- Self-documenting pages — The theme's own pages act as documentation; installing and previewing locally shows you real examples of the i18n patterns used, so you can learn by reading the source.
- Minimal footprint — The repository metadata describes it as "a minimal i18n astro theme" and it has earned 150 stars, indicating community use as a starting point.
Who is it for?
- Web developers who need to bootstrap a multilingual Astro site quickly — they can run
npm create astro@latest -- --template psephopaiktes/astro-i18n-starterto scaffold a project with preconfigured i18n routing. - Content-heavy teams managing a corporate site or documentation portal in multiple languages — the subdirectory URL structure makes each locale independently maintainable and indexable.
- Educators and learners exploring Astro's i18n capabilities — the self-documented pages and sample site provide a working reference implementation for the official pattern.
- Open-source contributors looking for a small, clean template to fork for their own multilingual projects or to extend with additional languages.
What can you do with Astro i18n Starter?
- Developers: Scaffold a new Astro project with the npm create command, then add localized pages in separate folders to get a working multilingual static site.
- Documentation authors: Use the built-in pages as a template for writing docs in multiple languages, each served at its own /language/ path.
- SEO specialists: Deploy the generated static site to any host, ensuring each language version has a unique URL for targeted search engine indexing.
- Indie hackers: Build a personal site or product landing page in several languages without pulling in a heavy CMS — just edit the content files and rebuild.
How does Astro i18n Starter work?
The template configures Astro's i18n feature to define a default locale and per-locale routing. Content is placed in language-specific subdirectories, and the build process generates static pages under each locale prefix. To get started, install the template via npm create astro@latest -- --template psephopaiktes/astro-i18n-starter, preview it locally, or visit the live sample at https://astro-i18n-starter.pages.dev/.
FAQ
What URL format does Astro i18n Starter support?
The template only supports the subdirectory URL format — for example, example.com/en/ and example.com/ja/. The root URL redirects to the default language, so there is no query-string or subdomain-based localization.
Does Astro i18n Starter require a CSS framework?
No, the theme ships with Vanilla CSS. You can add any framework later, but none is required to get styling working out of the box.
Is Astro i18n Starter free?
The template is open-source and available on GitHub; you can install and use it without paying a licensing fee. The exact license terms are not specified in the summary, but the repository is publicly accessible.
Can I add a new language to Astro i18n Starter?
Yes, you can add any language by creating a new subdirectory for that locale and dropping in the translated content. The routing follows Astro v4's official i18n configuration, so additional languages are a matter of adding folders and updating the config.
Where can I see a live demo?
A sample site is available at https://astro-i18n-starter.pages.dev/ — it demonstrates the English and Japanese versions of the same pages, complete with the default language redirect behavior.
