Documentation

Guides for users and developers of Midori Marketplace.

For Users

Install a Theme

  1. Browse the Marketplace and filter by "Themes".
  2. Click on the theme you like to preview it.
  3. Click "Install" to apply it to your new tab.
  4. The theme will be applied automatically. Open a new tab to see the changes.

Install a Wallpaper

  1. Browse the Marketplace and filter by "Wallpapers".
  2. Click on a wallpaper to see a full preview.
  3. Click "Install" to set it as your new tab background.
  4. Open a new tab to enjoy your new wallpaper.

Install a Widget

  1. Browse the Marketplace and filter by "Widgets".
  2. Click on a widget to preview its functionality.
  3. Click "Install" to add it to your new tab.
  4. The widget will appear on your new tab. You can reposition or remove it from settings.

Install an Animation

  1. Browse the Marketplace and filter by "Animations".
  2. Click on an animation to see it in action.
  3. Click "Install" to enable the animation on your new tab.

Manage Your Extensions

  • You can view and manage all installed extensions from your Midori new tab settings.
  • To uninstall an extension, go to settings and click "Remove" next to the item.
  • Extensions update automatically when a new version is published by the developer.

For Developers

Asset Contract (Schema)

Every extension published on Midori Marketplace must conform to the Midori Asset Contract. This JSON schema defines the structure of your extension metadata.

{
  "schemaVersion": "1.0.0",
  "kind": "midori-asset",
  "type": "theme | wallpaper | widget | animation",
  "id": "my-awesome-extension",
  "slug": "my-awesome-extension",
  "name": "My Awesome Extension",
  "status": "published",
  "compatibility": { ... },
  "distribution": { ... },
  "payload": { ... }
}

Create a Theme

  1. Define a JSON file with type "theme" following the Asset Contract schema.
  2. Set your color palette in the payload: primary, secondary, background, and accent colors.
  3. Include a preview screenshot (1280×800 recommended) for the Marketplace listing.
  4. Validate your contract using the provided validator tool.
  5. Submit it through the Marketplace for review.

Create a Wallpaper

  1. Prepare a high-quality image (minimum 1920×1080, JPEG or WebP recommended).
  2. Create a JSON contract with type "wallpaper" and reference your image in the payload.
  3. Include a thumbnail for the Marketplace preview.
  4. Validate your contract and ensure file sizes are within limits.
  5. Submit it through the Marketplace for review.

Create a Widget

  1. Define a JSON contract with type "widget" following the Asset Contract schema.
  2. Implement your widget HTML/CSS/JS inside the payload section.
  3. Widgets run in a sandboxed environment. Only the approved APIs are available.
  4. Test your widget locally in a Midori Browser development build.
  5. Submit it through the Marketplace for review.

Create an Animation

  1. Create a JSON contract with type "animation" following the Asset Contract schema.
  2. Define the animation using CSS animations or lightweight JS in the payload.
  3. Keep animations performant — avoid heavy DOM manipulation or large asset files.
  4. Submit it through the Marketplace for review.

Submit to the Marketplace

  1. Sign in to the Marketplace with your Astian Account.
  2. Go to your developer dashboard and click "Submit Extension".
  3. Upload your Asset Contract JSON and any required assets (images, files).
  4. Fill in the listing details: description, tags, license, and screenshots.
  5. Submit for review. The Midori team will review and approve or request changes.

Submission Guidelines

  • All extensions must follow the Midori Asset Contract schema (version 1.0.0).
  • Extensions must not contain malicious code, trackers, or excessive permissions.
  • Provide clear, accurate descriptions and high-quality preview images.
  • Respect intellectual property — do not upload content you do not own or have rights to.
  • Extensions that violate the guidelines will be removed and the developer account may be suspended.