# alshedivat/al-folio

A beautiful, simple, clean, and responsive Jekyll theme for academics

Repository: https://github.com/alshedivat/al-folio
Canonical: https://ross.abutalabs.com/products/al-folio
Homepage: https://alshedivat.github.io/al-folio/
Language: HTML
License: MIT
License Family: permissive
Topics: jekyll, jekyll-theme, academic, academic-website, personal-website, portfolio-website, theme, github-pages, jekyll-blog, hacktoberfest
Last push: 2026-08-24T05:05:07+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 96, longevity 100
- inputs: {"age_days": 3747, "days_push": 9, "days_rel": 24, "gap_med": 10.0, "n_releases_24m": 23}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 16060, forks 13081 (observed 2026-08-28T04:11:14.764893+00:00)

## What it is
al-folio is a clean, responsive Jekyll starter theme for academic personal websites, featuring publication rendering from BibTeX, blog posts, project portfolios, and CV pages. In v1.x it ships as independently versioned plugin gems, letting users update by bumping pinned versions in their Gemfile.

## Use cases
- create an academic personal website
- build a portfolio site for a researcher
- publish a publications page from a BibTeX file
- set up a personal blog on GitHub Pages
- make a CV website for a PhD student
- host a faculty homepage

## When to choose
- you are an academic or researcher wanting a personal site with publications, news, and blog
- you want free hosting on GitHub Pages with minimal setup
- you prefer a well-maintained, widely used Jekyll theme with Docker support

## When to avoid
- you need a dynamic backend or database-driven site
- you don't want to work with Ruby/Jekyll tooling
- you need a non-academic business or e-commerce site

## Facets
- artifact type: framework
- maturity: active
- function: static-site-generator, templating, theme
- domain: web-development, education, documentation
- platform: ruby
- tags: jekyll, jekyll-theme, academic-website, personal-website, portfolio, github-pages, cv, publications, blog, web-server, docker

## Member repositories
- alshedivat/al-folio (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:14.764893+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:05:15.106411+00:00, confidence not recorded.
  - readme: https://github.com/alshedivat/al-folio (fetched 2026-08-28T04:11:14.764893+00:00, sha cc656fca1f59)
  - homepage: https://alshedivat.github.io/al-folio/ (fetched 2026-08-29T08:02:55.703650+00:00, sha c0a935ced9a4)
- Data as of 2026-08-30T08:39:29.467469+00:00.