Single-file configuration: site profile, social links, pages, and themes are managed together in site.config.yml
AstroPortfolio
Lumina — Astro Portfolio Template
By YY-GX
Lumina is an Astro academic website template for researchers, professors, and doctoral students. It manages site information through a single YAML configuration file, supports reading BibTeX directly to generate publication lists, and includes multiple built-in themes and toggleable page types.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Desktop homepage1 / 3
Desktop captureTop of page
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-03View source
What stands out
A quick read of the recorded project description.
Native BibTeX support: place papers.bib to generate a publications page with conference labels, links, and author highlighting
18 toggleable page types, covering Publications, CV, Blog, Projects, Teaching, News, Team, Gallery, Talks, and more
10 themes and more than 50 color combinations, all supporting dark mode
Built with Astro and Tailwind CSS to produce static HTML, with no client-side JavaScript framework loaded
Includes a GitHub Pages deployment workflow, plus view transitions, Cmd+K search, RSS, sitemap, and SEO configuration
Template Details
Lumina is an Astro-based academic personal website template aimed at researchers, professors, and doctoral students. The site's main configuration is centralized in a single YAML file, site.config.yml, including profile, social links, page, and theme settings.
For content, the template natively supports BibTeX: after placing papers.bib into the project, it can generate a publications page with conference/journal labels, links, and author highlighting. Content formats also support Markdown, MDX, and YAML. The template provides 18 page types, covering Publications, CV, Blog, Projects, Teaching, News, Team, Gallery, Talks, and more, each of which can be enabled or disabled individually. Visually, it offers 10 themes and more than 50 color combinations, all usable with dark mode.
The tech stack is Astro and Tailwind CSS, building static HTML output with no client-side JavaScript framework loaded. The template includes a GitHub Pages Actions deployment workflow, as well as view transitions, Cmd+K search, RSS, sitemap, and SEO-related configuration.
Regarding usage limitations, the repository uses the MIT license, allowing free use, modification, commercial use, and distribution of this version of the code; when distributing, the copyright notice and the complete MIT license notice must be retained; the code is provided as-is. Third-party assets such as demo images, fonts, and icons require separate license verification and cannot be judged solely by the code's MIT license. External services such as domains and hosting may incur additional costs. Statements in the README such as "build a site in 5 minutes" and "perfect Lighthouse scores" are promotional descriptions and were not independently verified in this material.
AstroPortfolio
Is it right for your project?
Use Cases
- Researchers, professors, or doctoral students building a personal academic homepage to centrally present publications, CV, and teaching information
- Users who already have a BibTeX bibliography and want to automatically generate a searchable publications list page
- Needing to enable different sections such as blog, projects, news, team, gallery, and talks as required
- Wanting to quickly adjust the site's appearance by changing themes and color schemes, with dark mode support
- Hosting a static site on GitHub Pages and deploying it with the repository's included workflow
Suitable For
- Researchers with basic command-line skills who can edit a YAML configuration file
- Users who want to publish academic content as a static site without introducing a client-side JavaScript framework
- Academic personal site projects that need multi-page sections and theme-switching capabilities
- Users who accept the MIT license terms and can independently verify third-party asset licenses
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
After cloning the repository, run npm install to install dependencies, then edit site.config.yml to fill in personal information
- 2
Use npm run dev to preview at localhost:4321, and npm run build to build the static site
- 3
Place the BibTeX file for publications into the project to generate the publications list page
- 4
The repository includes a GitHub Pages Actions workflow, which can be adjusted as needed for deployment
- 5
Third-party assets such as demo images, fonts, and icons require separate license verification; external services such as domains and hosting may be charged separately
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version in the public repository under the MIT license; the free scope is the code of this version and does not mean that external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version of the code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete MIT license notice.
- The code is provided as-is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- The code uses the MIT license and can be used free of charge for personal and commercial purposes, but when distributing or republishing it, the copyright notice and complete MIT license text must be retained; the software is provided as-is without any warranty.
- Deployment relies on GitHub Pages and the repository's included Actions workflow, requiring a GitHub account; external services such as domains and hosting may incur additional costs.
- Before use, you need to edit site.config.yml yourself to fill in personal information, and have basic command-line and YAML editing skills.
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may be charged separately.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
MIT — free for personal and commercial use.
Original README
Deploy to GitHub Pages in one push — workflow included.
Original README
https://github.com/YY-GX/Lumina/blob/main/LICENSEhttps://github.com/YY-GX/Lumina/blob/main/README.mdEdit `site.config.yml` with your info, then:
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-03. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 83 / 100
- Technologies
- Astro
- Website type
- Portfolio
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2026-02-25
- Screenshot last checked
- 2026-10-03
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Astro as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Review declaration: [email protected] · 2026-10-04
Inspect the recorded source material
SHA-256: 4eb56e4972ebe1115635c1eab0ea5b3509b3869872e59d30bc3d0c603660ccd2
2026-10-03T23:23:01.905Z
Source file / repository# 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](https://yy-gx.github.io)** · **[Full Documentation](./docs/FEATURES.md)** · **[Installation](./docs/INSTALL.md)** · **[Usage Guide](./docs/USAGE.md)** --- ### 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 ```bash git clone https://github.com/YY-GX/Lumina.git my-site cd my-site npm install ``` Edit `site.config.yml` with your info, then: ```bash npm run dev # Preview at localhost:4321 npm run build # Build static site ``` Deploy to GitHub Pages in one push — workflow included. See **[Installation](./docs/INSTALL.md)** 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.
Explore similar templates
Compare previews and descriptions within the same stack and category.
astro-theme-cactus
Astro Cactus is an Astro-based blog and portfolio theme that uses Markdown/MDX content collections to manage posts, notes, and tags, with frontmatter type-checked by a schema.
Astro · Portfolio
astrofy
Astrofy is a free and open-source personal portfolio website template built with Astro and TailwindCSS, with built-in blog, CV timeline, project showcase, store, and RSS feed modules.
Astro · Portfolio
astro-nano
Astro Nano is a static, minimalist portfolio and blog template built with Astro, Tailwind, and TypeScript without frontend frameworks. It includes light/dark themes, animated UI, automatic sitemap and RSS feed generation, and Markdown/MDX support with component imports.
Astro · Portfolio
astro-erudite
astro-erudite is an opinionated, unstyled static blog template built with Astro and native CSS, with no UI or CSS framework and minimal dependencies.
Astro · Portfolio
astro-sphere
Astro Sphere is a static, minimalist portfolio and blog theme maintained by markhorn-dev, built mainly with Astro, Tailwind, and TypeScript, with a small amount of SolidJS for stateful components.
Astro · Portfolio
astro-micro
Astro Micro is a framework-free blog and portfolio theme for Astro, forked from Astro Nano. It adds Pagefind search and Giscus comments while retaining type safety, sitemap, RSS, Markdown and MDX support, and TailwindCSS with system, light, and dark themes.
Astro · Portfolio