Twilight

A CMS integrated static blog template built with Astro framework.

 

🖥️ Live Demo 📝 Documentation

English | 中文

---

📦 Installation

1. Clone the repository:

   git clone https://github.com/Spr-Aachen/Twilight.git
   cd Twilight

2. Install dependencies:

   # Install pnpm if not already installed
   npm install -g pnpm
   
   # Install project dependencies
   pnpm install

3. Configure your blog:

   • Edit src/config.ts to customize blog settings
   • Configure .env to support CMS functionality
   • Configure Umami analytics in .env
   • Update site information inside src/data

4. Start the development server:

   pnpm dev

🚀 Deployment

Deploy your blog to any static hosting platform

⚡ Commands

Command	Action
pnpm install	Install dependencies
pnpm dev	Start local dev server
pnpm build	Build production site to ./dist/
pnpm preview	Preview build locally before deployment
pnpm check	Run Astro error checking
pnpm format	Format code with Biome
pnpm lint	Check and fix code issues
pnpm new-post <filename>	Create a new blog post
pnpm astro ...	Run Astro CLI commands

🙏 Acknowledgements

• Based on the original Fuwari template
• Inspired by Yukina & Mizuki templates
• CMS functionality powered by astro-decap-cms-oauth
• Translation functionality powered by translate