GNOME Shell Extensions Development Guide

This skill provides comprehensive documentation for developing GNOME Shell Extensions using GJS (GNOME JavaScript).

Quick Reference

Extension Structure

extensionUUID@domain/
├── metadata.json    # Required: UUID, name, shell-version, url
├── extension.js     # Required: Extension class with enable()/disable()
├── prefs.js         # Optional: Preferences window (GTK4/Adwaita)
├── stylesheet.css   # Optional: Custom styling
├── schemas/         # Optional: GSettings schemas
│   └── org.gnome.shell.extensions.extension.gschema.xml
├── locale/          # Optional: Gettext translations
│   └── de/LC_MESSAGES/extension.mo
└── po/              # Optional: Translation source files