Submit a theme with a Pull Request
Submit a reviewable Theme Schema v4 source directory, not a prebuilt .ocskin. Trusted CI validates, packages and reads the archive back.
- 01
Copy the submission template
Fork the community repository and copy themes/_template to themes/<theme-id>/<version>/. New submissions accept Theme Schema v4 only.
- 02
Prepare the source directory
Include theme.json, declared assets/fonts, LICENSE.md, listing.json, a 1600×900 cover, and 1920×1080 home plus task/conversation screenshots.
- 03
Complete the permissive rights declaration
List known authors, sources, licenses or generation methods and declare your right to submit and permit redistribution. Contracts are not required, but misleading omissions are rejected.
- 04
Open a Pull Request
Read-only CI validates the directory, core Theme Schema, deterministic archive, read-back Manifest, screenshots and Catalog, with stable error codes and actionable fixes.
- 05
Wait for review and trusted publication
Maintainers inspect real visuals, privacy and obvious rights risks. After merge, trusted CI rebuilds from the merge commit, creates immutable Releases and deploys the site.
themes/
your-theme/
1.0.0/
theme.json
listing.json
LICENSE.md
preview.webp
screenshots/home.webp
screenshots/task.webp
assets/
fonts/