Contribute

Help make Yako better for everyone.

Report Bugs

Found a bug? Open an issue on our GitHub Issues page. Please include:

  • What happened and what you expected
  • Your browser and version
  • Your exported settings file (if relevant)
  • Screenshots or screen recordings if possible

Submit a Theme

Share your customized Yako setup with the community! Themes are displayed on the Themes gallery page.

How to submit

  1. Customize Yako to your liking
  2. Take a screenshot of your new tab page
  3. Export your settings from the Settings panel (Settings Management → Export)
  4. Fork the Yako repository
  5. Create a new folder under website/src/content/themes/ with a short slug name (e.g. dark-admin)
  6. Add three files to your folder:
    • index.md — metadata (see template below)
    • screenshot.png — your screenshot image
    • settings.json — your exported Yako settings
  7. Open a Pull Request

index.md template

---
title: "My Cool Theme"
description: "A short description of your theme"
author: "Your Name"
linkedin: "https://linkedin.com/in/yourprofile"
date: 2026-04-10
---

The linkedin field is optional. If provided, your name will link to your LinkedIn profile on the themes page.

Contribute Code

Yako is open source under GPL-3.0. To contribute code:

  1. Fork and clone the repository
  2. Install Deno
  3. Run deno install to install dependencies
  4. Run deno task edge (or chrome / firefox) to start the dev build
  5. Load the extension from the release/ folder in your browser
  6. Make your changes and open a Pull Request

Please run deno task format and deno task types before submitting.