Keebfolio is a curated list of open source mechanical keyboard resources built as a static website.
The project addresses the fragmentation of mechanical keyboard project information by collecting open source keyboard-related resources in one discoverable location. Contributors add content by creating Markdown files organized by category, with images automatically downloaded and optimized during the build process. The site is generated using Astro and deployed to a live homepage where visitors can browse keyboards, layouts, PCB designs, and firmware resources.
This tool suits anyone building a reference site for a niche hardware community or managing a crowdsourced collection of technical projects. It works well for projects where contributors submit content via pull requests and the maintainer wants to minimize friction in the contribution process. The automatic image optimization and remote URL handling mean contributors don't need to manage local assets. The project is appropriate if you need a simple static site with Markdown-based content management rather than a full CMS.
Development activity shows consistent maintenance of the contribution workflow. The project includes tooling to clean up unused downloaded images, keeping the repository tidy as content evolves. Contributor attribution is automatically fetched from the GitHub API and displayed in the footer, with caching to avoid rate limits. The homepage displays recent updates extracted from git history, filtering for documentation and feature commits to surface meaningful changes to visitors. The build system supports theme customization through a JSON configuration file, allowing new themes to appear automatically in the site header without code changes.
