Distributing a theme: start here
This section is for designers whose theme extension works and who want others to find, install and trust it. Build the extension first (Theme extensions: start here).
The one rule to remember
A published release is permanent. A tag pushed to a public repository, and the Composer version Packagist reads from it, can never be corrected. A mistake in a release is fixed by the next release. Read A pushed tag is permanent before your first release.
A reading order
- Where and how: Choosing where to publish, Creating the GitHub repository, A README that explains and sells.
- Licensing: Licensing choices: an overview.
- Versions and releases: Choosing a version number, Checking what is already published, Bumping the version before the tag, GitHub releases.
- Composer: Submitting a theme to Packagist, Keeping Packagist up to date automatically.
- Being found: Screenshots, Demo sites, projects.exponential.earth, share.exponential.earth.
- Final check: Checklist: before you publish.
Every page of this section
Related pages
- Selling themes and services: start here
- The maintenance life cycle: start here
- Free documentation: this page is free to copy, translate and improve under the GNU FDL 1.3.
Become an Exponential Partner
Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.