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

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.

Updating data sources

Yako ships no bundled Microsoft data. Portals, commands, and icons are all pulled hourly from upstream repositories, re-processed, and re-cached on getyako.com. See Architecture for the full pipeline. When a portal is missing, wrong, or has no icon, open a PR on the appropriate upstream repo — changes flow into Yako automatically within an hour.

Portal URLs, names, categories

Edit the relevant category file in adamfowlerit/msportals.io under _data/portals/. Changes flow into Yako's next hourly sync.

Product logos and icons

Add or update images in merill/MicrosoftCloudLogos (an append-only mirror of loryanstrant/MicrosoftCloudLogos ). Ensure each product directory has a metadata.md with name, altnames, status: Active, and a prodfamilies entry — those fields drive the icon picker's groupings and Yako's fuzzy icon matching.

cmd.ms commands

Edit website/config/commands.csv in merill/cmd. See the cmd.ms contributing guide .

Propagation: hourly poll plus instant repository_dispatch hooks where each upstream has opted in. In practice new content is live on getyako.com within a few minutes of the upstream merge.

🦘 Key Open Source Projects

Yako is proudly Aussie powered. These community projects make the extension possible:

MSPortals.io

Thanks to the collaboration with Adam Fowler, the full MSPortals.io directory is included as a built-in new tab view. The extension fetches portal data from the MSPortals.io GitHub repository.

Microsoft Cloud Logos

The quick link icons would not be possible without Loryan Strant's comprehensive collection of all Microsoft logos and icons. Browse the full collection at mscloudlogos.com or visit the GitHub repository.

Bonjourr

Yako is a fork of Bonjourr, a beautiful open source new tab extension created by Victor Azevedo and Tahoe Beetschen. We built on their excellent foundation to add Microsoft portal search, catalog integration, and admin-focused features. If you enjoy Yako, please consider starring Bonjourr on GitHub too.