Lumina — Academic Website Template

Build a stunning academic website in under 5 minutes. No frontend experience needed.

Lumina is an Astro-powered template designed for researchers, professors, and PhD students. Edit one YAML file, drop in your .bib, and you're live.

Live Demo · Full Documentation · Installation · Usage Guide

---

Why Lumina?

• One config file. Your entire site — profile, social links, pages, theme — lives in site.config.yml.
• BibTeX-native. Drop your papers.bib and get a beautiful, searchable publications page with venue badges, links, and author highlighting — automatically.
• 10 themes × 5 palettes = 50+ looks. Switch with one line. Every combination supports dark mode.
• 18 pages ready to go. Publications, CV, Blog, Projects, Teaching, News, Team, Gallery, Talks, and more. Toggle each on/off.
• Blazing fast. Static HTML. Zero JavaScript frameworks on the client. Perfect Lighthouse scores.

Quick Start

git clone https://github.com/YY-GX/Lumina.git my-site
cd my-site
npm install

Edit site.config.yml with your info, then:

npm run dev       # Preview at localhost:4321
npm run build     # Build static site

Deploy to GitHub Pages in one push — workflow included. See Installation for full setup.

At a Glance

Feature	Details
Framework	Astro 5 + TypeScript
Styling	Tailwind CSS 4
Content	Markdown, MDX, BibTeX, YAML
Themes	10 themes, 50+ color combos, dark mode
Pages	18 toggleable page types
Extras	View transitions, Cmd+K search, RSS, sitemap, SEO
Deploy	GitHub Pages (Actions workflow included)

License

MIT — free for personal and commercial use.