Carlisle is a minimal Hugo static-site template for personal websites and blogs, used as the basis for the custom themes across thesephist.com, linus.coffee, atypicalpress.com, and COVID Hacks.
What is Carlisle?
Carlisle is a minimal template for Hugo, the open-source static site generator. It takes Markdown content files and renders them into a static website with no database or server-side runtime. The template was created by the developer of thesephist.com and is licensed under the MIT License. It is designed to be forked and customized, and it can be deployed on Vercel using Hugo's official build integration.
Key Features
- Minimal Hugo theme — A text-first layout suited for personal sites, blogs, and simple project pages, with no extra dependency beyond Hugo itself.
- Static output — Hugo compiles all content into plain HTML, CSS, and JavaScript, so the resulting site loads quickly and can be hosted on any static host.
- Vercel deployment — The repository links to a Vercel guide for deploying Hugo sites, so the template can be hosted on Vercel with minimal configuration.
- MIT License — The template is freely usable and modifiable for personal or commercial projects, with attribution not required.
- Fork-and-customize workflow — You install Hugo locally, fork the repository, edit the content and layouts, and push to your own repository.
- Real-world usage — It powers the live sites thesephist.com, linus.coffee, atypicalpress.com, and COVID Hacks, which are public examples of the template in production.
- Live demo — A working demo is hosted at carlisle.thesephist.vercel.app so you can preview the default appearance before committing.
- Sample content — The repository includes example posts in the /content/posts/ directory, taken from Hugo Basic Examples and licensed under their independent MIT license.
Who is Carlisle for?
- Personal bloggers — People who want a minimal, readable blog where the focus stays on writing, and who are comfortable managing content as Markdown files.
- Developers building personal sites — Programmers who want a small codebase to fork, modify, and turn into a unique personal website or portfolio.
- Project and event sites — Teams creating simple informational sites, like the COVID Hacks example, that need a static site up quickly without a CMS.
- Hugo newcomers — Developers evaluating Hugo who want a tiny, well-structured theme to learn from; the codebase is short and easy to trace.
What can you do with Carlisle?
- Launch a personal homepage — Write a short intro in Markdown, add your projects, and deploy a minimal site to Vercel within minutes.
- Publish a blog — Add posts as Markdown files in /content/posts/ and Hugo generates the blog index and individual post pages automatically.
- Build a custom theme — Use Carlisle as the starting point for a bespoke Hugo theme; the source is MIT-licensed and compact enough to modify heavily.
- Deploy a fast static site — Because output is static, you can host it on Vercel, Netlify, GitHub Pages, or any other static host without server configuration.
How does Carlisle work?
To use Carlisle, install Hugo on your machine, fork the repository, then start customizing the content and layout files. Hugo builds the site into a public directory of static files, which you can deploy to Vercel or any static host. The demo at carlisle.thesephist.vercel.app shows the default output before changes.
FAQ
Is Carlisle free to use?
Yes. Carlisle is released under the MIT License, which permits free use, modification, and distribution for any purpose, including commercial projects, without requiring attribution.
Does Carlisle require a CMS or database?
No. Carlisle is a static site template for Hugo. All content is written in Markdown files, and Hugo builds the entire site into static HTML files. No database, CMS, or server-side runtime is needed.
How do I deploy Carlisle on Vercel?
The repository links to Vercel's official guide for deploying Hugo sites. You can import your forked repository into Vercel, set the build command to hugo, and Vercel will handle the build and hosting.
Can I use Carlisle for my own blog?
Yes. You can fork the repository, replace the sample content in /content/posts/ with your own Markdown posts, customize the theme, and publish. The sample content from Hugo Basic Examples is separately licensed but is only a starting point.
