ThoughtLite is a modern Astro theme for content-focused blogs, centered on long-form notes, quick jottings, multilingual support, and static deployment.
What is ThoughtLite?
ThoughtLite is an open-source Astro theme created by developer tuyuritio, focused on content creation. The theme takes Markdown files stored in the src/content directory and produces a responsive static blog site with light/dark mode, i18n support, sitemap, Atom feed, and Open Graph meta tags. It runs on Astro, uses Svelte for UI components, Tailwind CSS for styling, and is distributed under the GPLv3 license.
Key Features
- Responsive Design — The layout adapts to mobile, tablet, and desktop viewports.
- Light / Dark Mode — The theme auto-follows the system color scheme and includes a manual toggle.
- CSR Dynamic Content Filtering — List filtering and pagination work dynamically through the History API without full page reloads.
- i18n Support — Multilingual support is extensible; READMEs are provided in English, Simplified Chinese, and Japanese, and the theme also works in monolingual mode.
- Sitemap & Atom Feed — Both are generated automatically during the build process.
- OpenGraph Support — Built-in Open Graph meta tags optimize social media sharing previews.
- Content Types — Four content collections are included:
notefor long-form articles,jottingfor lightweight posts,prefacefor the homepage introduction, andinformationfor descriptive content. - Tech Stack — Astro, TypeScript, Svelte, Tailwind CSS, Iconify, Google Fonts / ZeoSeven Fonts, Medium Zoom for image viewing, Swup for SPA transitions, and Biome for code quality.
Who is it for?
- Bloggers and writers who want a fast static site to publish long-form notes and quick updates without installing a database or CMS.
- Developers who prefer an Astro starter with TypeScript, Svelte components, and Tailwind styling, and who want to customize layouts through Astro configuration files.
- Multilingual site owners who need i18n support and want documentation and UI strings available in multiple languages, with a fallback to monolingual mode.
- Static hosting users who want a theme that can be deployed on Vercel, Netlify, or any other static host because the
mainbranch builds to static HTML.
What can you do with ThoughtLite?
- Content creators: publish separate content types using the
noteandjottingcollections, scaffolding new files with thepnpm newcommand. - Multilingual bloggers: configure the i18n system to serve posts in several languages or keep it simpler with monolingual mode.
- Developers: run quality checks with
pnpm check,pnpm lint, andpnpm format, and sync upstream changes by adding the theme repository as a git remote and mergingtheme/main. - Cloudflare users: switch to the
cloudflarebranch to enable a built-in comment system that requires deployment on Cloudflare.
How does ThoughtLite work?
You can start a new project with pnpm create astro --template tuyuritio/astro-theme-thought-lite, follow the interactive prompts, then run pnpm dev to develop locally. Content lives in the src/content directory across the four collections, and the production build is produced with pnpm build, outputting static files for any host.
Pricing
ThoughtLite is free and open-source software released under the GPLv3 license. There are no paid tiers, and you may freely modify and distribute it as long as you retain the original copyright notice.
Alternatives
FAQ
Is ThoughtLite free?
Yes, ThoughtLite is free and open source under the GPLv3 license. You can use, modify, and distribute it, provided you keep the original copyright notice. There are no paid plans or hidden charges.
What content types does ThoughtLite support?
ThoughtLite includes four content collections in src/content: note for long-form, carefully crafted articles; jotting for lightweight, immediate posts; preface for the homepage introduction; and information for various descriptive content. You create content as Markdown files inside these folders.
Can I deploy ThoughtLite on any static hosting platform?
Yes, the main branch builds to a fully static site and can be deployed on Vercel, Netlify, or any static host. If you want the built-in comment system, switch to the cloudflare branch, which is designed to run on Cloudflare.
Does ThoughtLite have a built-in comment system?
The main branch does not include a comment system, but the cloudflare branch enables one. That branch requires deployment on Cloudflare to function.
How do I create a new post in ThoughtLite?
Use the provided command pnpm new to create a new content file, then edit it in the appropriate collection folder under src/content. After saving, run pnpm dev to preview locally or pnpm build to generate the production site.
