{ "doc": { "id": "app/references/roadmap", "title": "Roadmap for Cypress App", "description": "Learn about the roadmap for the Cypress App, including release stages and strategies for releasing and communicating changes.", "section": "app", "source_path": "/llm/markdown/app/references/roadmap.md", "version": "ce02913654e2655ee63448bdc92bb92c7b46a619", "updated_at": "2026-04-22T19:37:51.587Z", "headings": [ { "id": "app/references/roadmap#roadmap", "text": "Roadmap", "level": 1 }, { "id": "app/references/roadmap#cypress-app", "text": "Cypress App", "level": 2 }, { "id": "app/references/roadmap#release-stages", "text": "Release Stages", "level": 2 }, { "id": "app/references/roadmap#general-availability-ga", "text": "General Availability (GA)", "level": 3 }, { "id": "app/references/roadmap#beta", "text": "Beta", "level": 3 }, { "id": "app/references/roadmap#alpha", "text": "Alpha", "level": 3 }, { "id": "app/references/roadmap#experimental", "text": "Experimental", "level": 3 } ] }, "content": { "type": "root", "children": [ { "type": "heading", "depth": 1, "children": [ { "type": "text", "value": "Roadmap" } ] }, { "type": "heading", "depth": 2, "children": [ { "type": "text", "value": "Cypress App" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "At Cypress we love sharing what we are working on and are always striving to\nimprove transparency and communication with our community. If you are interested\nin learning more about what we have planned for the future of the Cypress App\ncheck out our\n" }, { "type": "link", "title": null, "url": "https://github.com/orgs/cypress-io/projects/13/views/1", "children": [ { "type": "text", "value": "Cypress App Priorities Board" } ] }, { "type": "text", "value": "." } ] }, { "type": "heading", "depth": 2, "children": [ { "type": "text", "value": "Release Stages" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Cypress follows Semantic Versioning\n(" }, { "type": "link", "title": null, "url": "https://semver.org/#summary", "children": [ { "type": "text", "value": "see summary here" } ] }, { "type": "text", "value": ") so that it is clear how you\nmay be affected when upgrading to a newer version of Cypress. If there is a\nminor version increment, `11.0.0` → `11.1.0` for example, you should not\nexperience disruption in your usage of Cypress. If there is a major version\nincrement, `11.1.0` → `12.0.0` for example, you may need to make changes to\ncontinue using Cypress. For most scenarios this is a valid way to consider how\ndisruptive upgrading to the next version of Cypress may be. In some cases,\nhowever, a feature of Cypress may be in a stage of development in which it does\nnot adhere to these rules." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "In order to help our users be aware of when this might be the case, we have\nconsolidated definitions of the different release stages: General Availability,\nBeta, Alpha, and Experimental. We also describe our approach to making and\ncommunicating changes in each stage." } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "General Availability (GA)" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Features that have reached General Availability are features that we have deemed\nto be feature complete and free of issues in the majority of use cases." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Strategies for releasing and communicating changes to GA features" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Modifications" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Modifications can be introduced during any release cycle and increment\nsemver" } ] } ] } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Breaking Changes" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Breaking changes will only be introduced during major releases in which\nsemver is bumped by a major version" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "In some cases early access to these changes are possible through public\npackages" } ] } ] } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Removals" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Removals will only be introduced during major releases in which semver is\nbumped by a major version" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "In the majority of cases, removals will be proceeded by a period in which\nthe feature is ‘deprecated’" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Migration steps will be provided to minimize pain points in these situations" } ] } ] } ] } ] } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "Beta" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Beta features may not be feature complete, but they should be close enough where\nmajor changes are not expected. Beta features consist of features that we are\nlooking to gather user feedback on by providing them as default functionality\nbefore an official release." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Strategies for releasing and communicating changes to Beta features" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Modifications" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Modifications can be introduced during any release cycle." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Modifications will be documented, with recommended code changes highlighted\nif appropriate." } ] } ] } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Breaking Changes" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Breaking changes can be introduced during any release cycle and do not bump\nsemver by a major version" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Breaking changes require in-app messaging to help users unblock themselves\nas needed" } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "The introduction and impact of breaking changes should be carefully\nconsidered at this stage as the cost to users is higher than with an alpha\nfeature." } ] } ] } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Removals" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Removal of any new functionality related to the feature can happen during\nany release cycle and will increment semver. These do not need to coincide\nwith a major release that is bumping semver by a major version." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Removals at this stage will be rare and a migration strategy along with\nreasoning for the removal will be documented." } ] } ] } ] } ] } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "Alpha" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Alpha features consist of features that we are looking to gather user feedback\non by providing them as default functionality before an official release. Alpha\nfeatures may not be feature complete and changes are possible during this stage." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Strategies for releasing and communicating changes to Alpha features" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Modifications" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Modifications can be introduced during any release cycle and may or may not\nincrement semver." } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Modifications will be documented, with recommended code changes highlighted\nif appropriate." } ] } ] } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Breaking Changes" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Breaking changes can be introduced during any release cycle and do not bump\nsemver by a major version" } ] } ] } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Removals" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Removal of any new functionality related to the feature can happen during\nany release cycle and does not bump semver by a major version." } ] } ] } ] } ] } ] }, { "type": "heading", "depth": 3, "children": [ { "type": "text", "value": "Experimental" } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Experimental features consist of features that we are looking to gather user\nfeedback on before we commit fully to further development of the feature. These\ntype of features require you to opt-in to via a configuration value prefixed\nwith `experimental`. These types of features may be unstable and contain issues.\nYou should expect to see frequent changes and improvements during the feature’s\nexperimental lifetime. The current experimental features can be found\n" }, { "type": "link", "title": null, "url": "/llm/markdown/app/references/experiments.md", "children": [ { "type": "text", "value": "here" } ] }, { "type": "text", "value": "." } ] }, { "type": "paragraph", "children": [ { "type": "text", "value": "Strategies for releasing and communicating changes to experimental features" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Modifications" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Modifications can be introduced during any release cycle and may or may not\nincrement semver." } ] } ] } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Breaking Changes" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Breaking changes can be introduced during any release cycle and do not bump\nsemver by a major version." } ] } ] } ] } ] }, { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Removals" } ] }, { "type": "list", "ordered": false, "start": null, "spread": false, "children": [ { "type": "listItem", "spread": false, "checked": null, "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Removal of any new functionality related to the feature or the feature in\nits entirety can happen during any release cycle and will not be accompanied\nby a major semver version change." } ] } ] } ] } ] } ] } ] }, "token_estimate": 1120 }