ThoughtLite

A modern Astro theme, focused on content creation 🌟

English 简体中文 日本語

Note

• main branch✅: Static build, can be deployed on any static hosting platform.
• cloudflare branch: Enables built-in comment system, only deployable on Cloudflare.

🎬 Live Demo: Vercel

✨ Features

• Responsive Design - Adaptive for mobile, tablet, and desktop.
• Light / Dark Mode - Auto-follows system preference with manual toggle support.
• CSR Dynamic Content Filtering - List filtering and pagination via History API.
• i18n Support - Extensible multilingual support, also works perfectly in monolingual mode.
• Sitemap & Feed Subscription - Automated generation of Sitemap and Atom Feed.
• OpenGraph Support - Built-in Open Graph meta tags for optimized social media sharing.

⚡️ Quick Start

Using Astro Command

Run the following command:

pnpm create astro --template tuyuritio/astro-theme-thought-lite

# Follow the interactive prompts to create the project

cd <your-project-name>
pnpm dev

Using Template

1. Use this template to create a new repository or fork this repository.
2. Run the following commands:

git clone <your-repo-url>
cd <your-repo-name>
pnpm install
pnpm dev

🔧 Configuration

Customize site configuration and internationalization (i18n) by modifying the following files:

• .env
• astro.config.ts
• site.config.ts

For basic configuration, refer to the Site Configuration Guide.

For i18n configuration, refer to the Internationalization Configuration Guide.

💻 Commands

The theme provides the following commonly used commands:

Command	Action
pnpm install	Install project dependencies
pnpm update	Update project dependencies
pnpm new	Create a new content file
pnpm dev	Start the local development server (default: http://localhost:4321)
pnpm check	Run Astro type checking
pnpm build	Build the production version
pnpm preview	Preview the built site
pnpm format	Format code
pnpm lint	Lint code

🚀 Deployment

The current branch can be fully static built and deployed on any static hosting platform.

For deployment methods on various platforms, refer to the Astro Official Deployment Guide.

🔄 Updates

Run the following commands to sync upstream updates:

git remote add theme https://github.com/tuyuritio/astro-theme-thought-lite.git
git fetch theme
git merge theme/main    # Add `--allow-unrelated-histories` flag for first update
pnpm install

✍️ Content Creation

Content creation is centralized in the src/content directory, mainly including:

• note - Focused on carefully crafted and detailed long-form works
• jotting - Lightweight and immediate content recording
• preface - Displayed on the homepage as the first impression
• information - Containing various descriptive content

For details, refer to the Content Creation Guide.

🤝 Contributing

All kinds of contributions are welcome and appreciated!

• Help promote the project or assist other users
• Report issues or suggest new features
• Improve documentation or help with internationalization (i18n)
• Submit code contributions - see the Code Contribution Guide for more details

🙏 Acknowledgments

Tech Stack

• Core Framework - Astro
• Core Language - TypeScript
• UI Components - Svelte
• CSS Engine - Tailwind CSS
• Icons - Iconify
• Fonts - Google Fonts | ZeoSeven Fonts
• Image Viewer - Medium Zoom
• SPA Transitions - Swup
• Time Handling - Luxon
• Code Quality - Biome
• Static Deployment - Vercel

Inspiration

• Astro Sphere
• astro-vitesse
• Miniblog
• AstroPaper with I18n

📜 License

This project is licensed under GPLv3, allowing free modification and distribution, but the original copyright notice must be retained.

AstroThought