Skip to content

Switch branches on p5.js so that 2.x is the main branch #8871

Description

@ksen0

Please see the parent issue for timeline and context. Please feel free to raise questions, concerns, or overlooked tasks; however, the work will be done by the maintainers, so it is not open to implementation volunteers.

When this task is done, on the p5.js repository, the main branch will include p5.js version 2 latest (currently dev-2.0), and a v1 branch will contain version 1 latest (currently main). This task does not affect the website or the editor, please see parent issue for more info.

Steps we will take:

  • Merge prerequisite PR that:
    • updates contributor docs to refer to correct branch
    • updates all release workflows to refer to the correct branch
    • Note: in both cases, links refer to current website properties (beta.p5js is 2.x and p5js is 1.x)
  • Switch default branch form main to dev-2.0
  • Rename main to v1
  • Rename dev-2.0 to main
  • Release patches in both branches, resolve any issues if they arise Not strictly necessary, no substantive updates to contribtior docs were made

After this is completed, PRs will likely need to be rebased.

Activity

  1. added this to the v2 Default Switch milestone on Jun 3, 2026
  2. ksen0 commented on Jun 9, 2026

    @ksen0
    MemberAuthor

    Note after Discord question: if by the time the switch happens there is only minor bugfixes and documentation updates in a branch, a patch will be released right after the switch. If there is more substantial changes on that branch, then the normal 1 week of RC patch release process can be followed. Leading up to the branches switch, neither dev-2.0 nor main are frozen.

  3. ksen0 commented on Jun 10, 2026

    @ksen0
    MemberAuthor

    Here's some helpful guidance from GH on how to update your local clone:

    The default branch has been renamed!
    dev-2.0 is now named main

    If you have a local clone, you can update it by running the following commands.

    git branch -m main v1
    git branch -m dev-2.0 main
    git fetch origin
    git branch -u origin/main main
    git remote set-head origin -a
  4. nbogie commented on Jun 15, 2026

    @nbogie
    Contributor

    Hi @ksen0 I think these instructions are maybe missing a first step to rename local main to be v1 before trying to rename local dev-2.0 as main.

  5. ksen0 commented on Jun 15, 2026

    @ksen0
    MemberAuthor

    Thanks @nbogie updated my comment

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

Required for p5v1 FreezeIndicates this issue should be closed before p5.js v1 can be frozen to bugfixes and doc updatesp5v2 switch: required

Type

No type

Projects

Relationships

None yet

Development

No branches or pull requests

Issue actions