Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,059 of 9,059 pages
About the help in other languages
All help pages

The maintenance life cycle: start here

The map for keeping a theme alive after its first release - following Exponential releases, upgrade testing, per-release accessibility, CSP and performance audits, security fixes, deprecation, end of life, handover…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/designers/lifecycle/lifecycle-start-here.md

On this page

The maintenance life cycle: start here

This section is for designers who have released a theme and now carry it. A theme lives as long as Exponential, PHP and browsers keep moving; each of them changes something every year. Maintenance is what keeps your users' sites working.

The cycle in one picture

  1. Watch what changes: Exponential releases, PHP versions, libraries, browsers.
  2. Test your theme against each change in an upgrade test environment.
  3. Audit the release: accessibility, Content Security Policy, look in light and dark and at zoom, performance.
  4. Fix and release a new version, security fixes first.
  5. Communicate: changelog, release notes, deprecations, and one day the end of life or a handover.

A reading order

  1. The life cycle of a theme, A support policy for your theme.
  2. Compatibility: Following Exponential releases, Reading a changelog as a designer, A compatibility matrix, PHP version compatibility.
  3. Testing: An upgrade test environment, Upgrade testing, step by step.
  4. Audits: Accessibility, CSP, Visual regression, Performance.
  5. Security: Security fixes in themes, Handling security reports, Publishing a security release.
  6. Change and endings: A deprecation policy, Breaking changes, End of life, Handing a theme over.
  7. Forks and community: Forking a theme, Rebranding a fork, fairly, Contributing back upstream.

Every page of this section

PageWhat it answers
The life cycle of a themeThe stages from first release to archive
A support policy for your themeWhich versions you maintain
Following Exponential releasesWhere changes are announced
Reading a changelog as a designerWhat matters to a theme
A compatibility matrixTheme versions against Exponential and PHP
PHP version compatibilityPHP 8.0 and later (PHP 7.4 usable without support)
Declaring compatibilityWhere users read it
An upgrade test environmentA safe place to test
Upgrade testing, step by stepThe routine
Comparing your overrides with the standard templatesFinding drift
JavaScript library upgradesjQuery 4, no YUI
Removing inline scripts and stylesGetting CSP-ready
An accessibility audit for every releaseThe routine
A CSP audit for every releaseThe routine
Visual regression checksLight, dark, zoom
A performance audit for every releaseThe routine
Security fixes in themesTypical problems and fixes
Handling security reportsFrom report to fix
Publishing a security releaseFix, release, describe
Keeping dependencies up to dateLibraries and extensions
A deprecation policyHow you retire things
Deprecating a setting or a templateStep by step
Breaking changes and the next major versionWhen users must act
End of lifeStopping maintenance well
Announcing end of lifeWhat to say
Archiving a repositoryRead-only, still installable
Handing a theme overA new maintainer
Transferring the repository and the Packagist packageMoving ownership
Adopting an abandoned themeTaking over
Forking a themeWhen and how
Rebranding a fork, fairlyNames, notices, credit
Credits and attributionWho to name
Contributing back upstreamShared growth
Pull requests to someone else's themeGood pull requests
Keeping a fork in syncUpstream changes
A maintenance calendarThe yearly rhythm
Checklist: one maintenance cycleThe routine as a list

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.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x