Keebfolio

The goal of this repository is to collect mechanical keyboard related projects (preferably Open Source).

View the pages on Keebfolio.netlify.app

Contributing

Contributions are welcome!

Adding Content

To add content, create a new Markdown file in src/content/keyboards/[category]/. You can copy an existing file as a template.

New Image Policy:

• You should use remote URLs (e.g. https://github.com/.../image.jpg).
• The build process will automatically download and optimize them for you.

Development Environment

1. Clone the repository.
2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

   Open http://localhost:4321 to view the site.

Adding a Theme

Themes are defined in src/data/themes.json. To add a new theme, add an entry:

"theme-id": {
  "name": "Display Name",
  "background": "#hexcolor",
  "foreground": "#hexcolor",
  "accent": "#hexcolor"
}

The theme will automatically appear in the header dropdown.

Housekeeping

• Cleanup Unused Images:

  npm run cleanup

  This deletes any downloaded images that are no longer referenced in your Markdown files.

Contributors Display

Each page displays GitHub contributor avatars at the bottom. Contributors are fetched from the GitHub API during build and cached for 1 hour.

To increase the API rate limit (recommended for frequent builds):

1. Create a GitHub Personal Access Token at https://github.com/settings/tokens (no special scopes needed)
2. Copy .env.example to .env and add your token:

   cp .env.example .env
   # Edit .env and add your GITHUB_TOKEN

License