No description
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-22 17:28:27 +01:00
.forgejo/issue_template Changed: generic issue title 2026-11-22 17:28:27 +01:00
README.md Init 2026-11-22 17:00:13 +01:00

Logo

Spitfire Community Packages

Publish wallpapers, sounds, music, colors, cursors, fonts, emoji, icons and browser layouts in about:store.

🚀 Publish

  1. Open a New package issue to get your Community/<app ID> repo.
  2. Add your files in the layout below and push.
  3. Tag the version from package.ini:
git tag v1.0 && git push --tags

After a review the package shows up in about:store. For an update, raise version and tag again.

🗂 Layout

package.ini
icon.png                       also .svg .webp .jpg .avif .gif
description.md                 long description for the store
wallpaper/dark.webm            image or video, also light.*
wallpaper/dark-still.jpg       frame shown before the video plays
sounds/CLICK.mp3               browser sounds, more as CLICK.2.mp3
keysounds/TYPING_LETTER.mp3    TYPING_LETTER, TYPING_SPACE, TYPING_ENTER, TYPING_BACKSPACE
music/1.mp3                    layers of one track, played together
webstyle/1.css                 page styles, needs [webstyle] match
cursors/pointer.cur            CSS cursor name, .cur or .png
fonts/header-700-italic.ttf    header or body, weight and -italic optional
emoji/MyEmoji.ttf              .ttf or .otf
icons/back.svg                 an icon pack, with kind = icons
userChrome.css                 a browser layout, with kind = layout
extension/manifest.json        a WebExtension, signed by Mozilla when published
theme/manifest.json            a Firefox static theme, also with wallpaper/ and the other folders

Sounds: CLICK, HOVER, HOVER_UP, SWITCH_TOGGLE, TAB_INSERT, TAB_CLOSE, TAB_SLASH, FEATURE_SWITCH_ON, FEATURE_SWITCH_OFF, IMPORTANT_CLICK, LIMITER_ON, LIMITER_OFF, LEVEL_UPGRADE.

📝 package.ini

[package]
name = Sunset
version = 1.0
description = Warm evening colors with ocean sounds
developer = Alice
license = CC0-1.0
kind = layout            ; only for a layout, or icons for an icon pack

[wallpaper.dark]         ; [wallpaper] for both sides
text_color = #FFFFFF

[accent]                 ; "h s l"
accent = 24 90 60

[webstyle]
match = https://*.example.com/*

📜 Rules

  • Everything in the package is yours or shared under a license that allows it.
  • Everything the package needs is in the package or a dependency, and nothing loads from the network.
  • Readable source only, no minified or encoded code.
  • The code and look match what the package says it is. A theme changes how the browser looks, so a theme that reaches deeper into browser settings is refused.
  • user.js leaves security, privacy, proxy and update prefs alone.
  • Don't spam repo creation. Finish and release one package before you request the next.
  • An App ID outside xyz.weforge.<your user> must be listed in https://<domain>/.well-known/srepo.txt, for io.github.example.Sunset that is example.github.io.