MultiTerm Astro 🎨⚡️

MultiTerm is an Astro blog theme designed for coders who love their color schemes. Easily theme your whole website with your favorite color schemes and have your prose rendered with a nod to the aesthetics of raw markdown.

Check out the live example site here!

v2.0.0 has been released! 🥳

✨ Features

• Amazing Theme Selection: Personalize your blog's appearance with your favorite editor color scheme. Pick your favorite Shiki themes bundled with Expressive Code.
• Dark/Light/Auto Theme Mode: Choose any two Shiki themes and use the standard light/dark/auto model for automatically adapting to your reader's theme preferences with button in the site header.
• Multiple Theme Mode: Choose three (or all 59!) Shiki themes and allow your reader to choose their favorite from a dialog menu opened from a button in the header. Every element seamlessly changes color interactively using the magic of CSS variables.
• GitHub Comment Section: Allow readers to respond, discuss, and react with a comment section powered by GitHub and Giscus. Painstakingly themed to match your site perfectly.
• GitHub Activity Widget: Optionally include a statically generated GitHub activity calendar on the homepage that (of course) matches the active color scheme perfectly.
• Markdown Extensions: Admonitions, auto-generated TOC that sticks to the side on large screens, emoji shortcodes, KaTeX math, MDX, and reading time estimates. See the example site's Showing Off Blog Features post.
• RSS Feed and Sitemap: Built-in support for RSS feeds and sitemap with no extra configuration.
• Social Links: Easily include links to common developer platforms including GitHub, Mastodon, Twitter, LinkedIn and E-mail.
• Responsive Design: Optimized for all devices from desktops to mobile phones. Built with Tailwind v4.
• SEO Optimized: Boost your site's visibility with built-in SEO best practices and automatically generated social card images for every page via Satori.
• Customizable Build: Powered by Astro, render as a static site (the default) or generate content dynamically.

Check out the example site PageSpeed scores and OpenGraph analysis

🚀 Getting Started

Clone the Repository:

git clone --depth 1 https://github.com/stelcodes/multiterm-astro my-new-blog && cd my-new-blog

Install Dependencies:

npm install

Start the Development Server:

npm run dev

Build Your Site and View the Results:

npm run build && npx serve dist

🛠️ Configuration

Simple configuration is a core feature of MultiTerm. All configuration is done from a single file: src/site.config.ts. This is where you can tailor your website to match your vision.

Please take a look at src/site.config.ts for more information about the configuration options.

To add your own content, check out the src/content directory. Feel free to remove all the example content and replace it with your own!

📄 License

This project is licensed under the MIT License.

Inspiration

• https://github.com/panr/hugo-theme-terminal
• https://github.com/chrismwilliams/astro-theme-cactus

🩷 Sponsor

Consider buying me a coffee to keep me caffeinated while I work on open source projects like this one!