Hi community,
We are replacing the design-system-mirror
repository that we currently provide with a new, expanded atlassian-frontend-mirror
repository that will include the source code for all public @atlaskit packages. All the code in the current mirror will be in the new mirror. We are using a new name for the mirror to accurately reflect that it includes more than just Atlassian Design System code.
In replacing rather than renaming the mirror, any references you have to the existing repository will continue to work without interruption, although you will need to change the URLs in order to continue getting updates.
I know many of you have requested this, and it has taken us some time to set this up — thank you for your patience.
What’s changing?
- A new
atlassian-frontend-mirror
repository is being provided, which includes the source code for all public packages available on npm in the @atlaskit scope. It is a public mirror of that code in our internal Atlassian Frontend repository. The mirror will be updated nightly. - The
design-system-mirror
repository will be retired. To make it easier for you to switch over without diverging history (see below), this repository will remain accessible until 30 Nov 2020, but it will no longer be updated. - We are updating the readme in the repository, as well as the Get Started guide in our documentation.
What’s not changing?
- All code in the current mirror repository will also be in the new repository.
- Packages on npm continue to be available as they are today.
- There is no change to licensing.
How will this impact you?
If you reference the current repository, you will need to update the remote URL to point to the new repository:
git remote set-url origin git@bitbucket.org:atlassian/atlassian-frontend-mirror.git
git pull
The history between both repositories should line up exactly, so it should be treated as a straightforward rename/URL change. (This is why we will not be updating the existing repository.)
Alternatively, you can clone the new repository directly:
git clone git@bitbucket.org:atlassian/atlassian-frontend-mirror.git
A note about support
We continue to provide guidance and support for packages that are part of the Atlassian Design System (corresponding to the /design-system folder in the repository). We are committed to ongoing improvements, fixing bugs, and adding new features as part of our roadmap. If you need help, have questions or would like to report an issue, please start a new topic here in the Ecosystem Design forum.
The new mirror repository also contains the code for packages outside the Design System. Please keep in mind that the level of support varies between each of those packages. They are owned by different teams within Atlassian and are primarily intended for internal use. We will monitor the forums and try our best to direct topics to the appropriate maintainers, but some packages are made available without official support.
Cheers,
Stephen