Skip to main content

Welcome to as-folio

Welcome to as-folio — a modern academic portfolio template built with Astro 6 that mirrors the popular al-folio Jekyll theme.

What is as-folio?

as-folio gives you everything al-folio offers — publications, CV, blog, projects, people pages, dark mode, KaTeX math, and more — while running on the Astro framework with:

  • Astro 6 — ultra-fast static site generation
  • Tailwind CSS v4 — modern utility-first styling
  • TypeScript — fully typed configuration
  • Pagefind — instant static search (⌘K)

Getting Started

Fork this repository and update src/config/site.ts with your details:

export const site = {
  title: 'Your Name',
  author: {
    name: 'Your Name',
    email: 'you@example.com',
    // ...
  },
  // ...
};

Then add your content:

Content typeLocation
Blog postssrc/content/posts/
Publicationssrc/data/papers.bib
Projectssrc/content/projects/
CVsrc/data/cv.yml
About biosrc/data/about.mdx

Deploy

Push to GitHub and enable GitHub Pages — the included deploy.yml workflow handles the rest.

Happy publishing!