Newsletter
Join the Community
Subscribe to our newsletter for the latest news and updates
A fast, minimalist Astro template for academic portfolios that turns Markdown files into a personal site with blog, publications, projects, talks, and CV.
A dark portfolio & blog theme for Astro with a live 5,000-particle Three.js background, blog system, and glassmorphism UI.
Academic Portfolio Astro is an open-source Astro template for building a personal academic portfolio site, publishing bio, blog, publications, projects, talks, CV, and teaching content entirely from Markdown files.
Academic Portfolio Astro is a static site generator template built on Astro, Tailwind CSS v4, and TypeScript that takes Markdown files as its only input and produces a fast, two-column portfolio website as output. It is designed specifically for academics — researchers, professors, and PhD students — and is distributed as a GitHub template repository. The layout features a sticky left profile sidebar and a scrollable main content area, and all site configuration is centralized in the src/config directory.
.md files in src/content, with no programming knowledge required.remark-math and rehype-katex, giving you out-of-the-box support for scholarly equations.themes.ts and applied via THEME_CONFIG in site.ts.pages.ts.@tailwindcss/vite, yielding near-perfect Lighthouse scores and minimal client-side JavaScript.umami.websiteId) and Google Analytics 4 (ga4Id) in site.ts.Academic Portfolio Astro is for researchers, professors, and PhD students who need a professional online presence without hand-coding a website. A professor can publish a publication list with LaTeX abstracts and a teaching page; a PhD student can maintain a research blog and project showcase; a researcher can create a CV page and link to their social profiles. Because all content lives in Markdown, these users can update their site without touching UI code.
Start by creating a new repository from the rubzip/academic-portfolio-astro template via GitHub CLI (gh repo create my-portfolio --template="rubzip/academic-portfolio-astro" --clone) or by cloning the repository with git. Then install dependencies with npm install (requires Node.js version 22.12.0 or higher) and run the development server with npm run dev — the site appears at http://localhost:4321. To customize content, edit the Markdown files under src/content and adjust global settings in src/config.
Academic Portfolio Astro is free and open source, released under the MIT License. There are no paid tiers or premium features — you can use it commercially without restriction and modify it as needed.
Yes, the template is open source under the MIT License, so it is completely free to use, modify, and deploy, including for commercial academic projects.
No. All content is written in Markdown files under src/content, and all global configuration lives in src/config — you can update your bio, publications, and teaching pages without writing any UI code.
The project requires Node.js version 22.12.0 or higher. After installing Node, run npm install and npm run dev to start the local server on port 4321.
Yes. Each page section (talks, teaching, etc.) can be enabled or disabled globally using a boolean flag in the src/config/pages.ts file.
Yes, the template includes LaTeX rendering out of the box using the remark-math and rehype-katex plugins, so you can include mathematical equations in your publications, blog posts, and other Markdown content.
