Manual theme template (advanced)

A technical template for users who choose to edit Chrome theme files manually.


If you already use the Awetheme creator, you usually do not need this page—exporting a ZIP generates a complete config automatically.

Below is a template that stays as small as possible but can still be published, for people who edit by hand or integrate with other tools.

Folder after unzip

my-theme/
|-- manifest.json
|-- icons/
|   `-- icon-128.png
`-- images/
    `-- theme_ntp_background.jpg   (optional)

When zipping, manifest.json should appear directly at the root of the archive—not inside an extra folder.

Minimal config example

{
  "manifest_version": 3,
  "name": "My Minimal Theme",
  "version": "1.0.0",
  "description": "A minimal Chrome theme template.",
  "icons": {
    "128": "icons/icon-128.png"
  },
  "theme": {
    "colors": {
      "frame": [26, 32, 44],
      "toolbar": [241, 243, 244],
      "tab_text": [15, 23, 42],
      "ntp_background": [255, 255, 255],
      "ntp_text": [15, 23, 42],
      "ntp_link": [37, 99, 235],
      "omnibox_background": [255, 255, 255],
      "omnibox_text": [71, 85, 105]
    },
    "images": {
      "theme_ntp_background": "images/theme_ntp_background.jpg"
    },
    "properties": {
      "ntp_background_alignment": "center",
      "ntp_background_repeat": "no-repeat"
    }
  }
}

What each part maps to in the UI:

  • Colors: window frame, toolbar, tab text, new tab page background/text/links, address bar
  • Images: optional new tab page background; remove the entire images block if you do not use one
  • Layout: background alignment and repeat; you can keep these even without a background image

Before packaging

  • manifest.json is at the ZIP root
  • Icon files exist and paths are correct
  • Every referenced image is inside the package
  • Do not use external image URLs