@jamesodwyer/gds-figma-vite 1.0.3 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,12 +1,16 @@
1
1
  # Global Design System Component Library
2
2
 
3
- View the latest build of the GDS documentation site at: <http://global-design-system.git.tmaws.io/gds>
3
+ A shared React component library built with styled-components.
4
+
5
+ ## NPM
6
+
7
+ https://www.npmjs.com/package/@jamesodwyer/gds-figma-vite
4
8
 
5
9
  ## Contributing
6
10
 
7
11
  ### Icons
8
12
 
9
- View the instructions on adding new icons at: <http://global-design-system.git.tmaws.io/gds/?path=/docs/icons--docs#adding-new-themeable-icons>
13
+ View the instructions on adding new icons in the Storybook documentation.
10
14
 
11
15
  ## Storybook
12
16
 
@@ -8,7 +8,7 @@ Global Design System (GDS) is a shareable pattern library. It exposes both core
8
8
 
9
9
  Formerly known as Mosaic, GDS is based on pure JS objects for the core variables, React for the components, Styled Components for the UI library (as the most widely adopted) and polished for some of the color interpolations (optional). All elements in GDS are built in a way so they can be imported individually without the need to import the whole library. They are also built with emphasis on flexibility and accessibility.
10
10
 
11
- It is currently being used in several Ticketmaster projects including [ICCP Frontend](https://git.tmaws.io/intl-ccp/iccp), the [Microflex mobile app](https://git.tmaws.io/intl-ccp/mobile/iccp-app), and the [Resale checkout](https://git.tmaws.io/intl-resale/checkout/checkout-app).
11
+ It provides reusable UI components, icons, stickers, and theming utilities for React applications.
12
12
 
13
13
  This Storybook is a helpful resource with a guide to every component we have as well as all the spacing values, colours and icons we have access to. You can play around with the controls in each canvas to see the different variants of the component.
14
14
  If you click the Docs link in the top left corner, you can see some documentation with extra notes on how you can (and can’t) configure/use a component.
@@ -84,6 +84,5 @@ When opening a merge request, please remember to fill out the template fully. Yo
84
84
 
85
85
  ## Links
86
86
 
87
- - Slack channel: [#global-design-system](https://ticketmaster.slack.com/archives/C8SM3AUKE)
88
- - Repo: https://git.tmaws.io/global-design-system/gds
89
- - Jira project: https://jira.livenation.com/projects/GDS/issues
87
+ - Repo: https://github.com/jamesodwyer/gds-figma-vite
88
+ - NPM: https://www.npmjs.com/package/@jamesodwyer/gds-figma-vite
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jamesodwyer/gds-figma-vite",
3
- "version": "1.0.3",
3
+ "version": "1.0.5",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },
@@ -57,7 +57,7 @@
57
57
  "prettier": {},
58
58
  "repository": {
59
59
  "type": "git",
60
- "url": "https://git.tmaws.io/global-design-system/gds"
60
+ "url": "https://github.com/jamesodwyer/gds-figma-vite"
61
61
  },
62
62
  "author": "TMFE",
63
63
  "license": "UNLICENSED",
@@ -1,155 +0,0 @@
1
- import { Meta } from "@storybook/addon-docs/blocks";
2
-
3
- <Meta title="Docs/Releasing" />
4
-
5
- # Releasing GDS
6
-
7
- Once you have the code review approved, you merge to master and let the pipeline run.
8
- When it's all green you create a tag in GitLab in the same way as you do in your repo.
9
- A release of `GDS` is performed by adding a Git tag to the `master` branch. Tagging master will trigger a CI pipeline which will build and release the new version of the package to npm.
10
-
11
- ## How to prepare a tag
12
-
13
- You'll need to build some release notes for the tag, so this preparation step gives you one way to do that. There are multiple approaches, but this one is quite user-friendly.
14
-
15
- ### 1. Make sure the master pipeline is passing on CI
16
-
17
- Check that the [latest master pipeline](https://git.tmaws.io/global-design-system/gds/-/pipelines?page=1&scope=all&ref=master) passed on CI (has a green tick)
18
-
19
- Check your pipeline that ran as part of your MR to ensure each step passed
20
-
21
- ### 2. Build the release notes
22
-
23
- Run the following gds repo script in the terminal:
24
-
25
- ```bash
26
- ./scripts/merges-since-last-tag.sh
27
- ```
28
-
29
- This will helpfully print a list of all the commits to master since the previous tag.
30
-
31
- Post this list in the [#global-design-system](https://livenation.enterprise.slack.com/archives/C8SM3AUKE) Slack channel to let people know a tag is incoming. If no objections have been raised within ~10 minutes, proceed with the tag.
32
-
33
- ### 3. Go back to "[Deployments > Releases](https://git.tmaws.io/global-design-system/gds/-/releases)" in GitLab and click "New release"
34
-
35
- - Give the tag a name (its release number) following the semantic versioning pattern (`major.minor.patch`). Most "daily" releases are generally classed as minor.
36
- Enter this new version number in the "Search or create tag name" field. Under the autocomplete list, it will prompt you to "Create tag [version]"
37
- - Make sure the tag is created from `master` and paste the release notes into the tag message field
38
- - Leave the Release title, Milestones and Release date fields as they are
39
- - Paste the same release notes into the "Release notes" field. This is a markdown field, so we can format it as a list for easy readability
40
- - Remove any duplicates and make sure the Jira numbers are correctly formatted (case sensitive) - this will help you in a bit!
41
- - Note: doing this will highlight the importance of good/standard commit messages!
42
- - Click "Create release". This will trigger a pipeline that builds and release the new version of the package to npm.
43
- - [GDS pipeline here](https://git.tmaws.io/global-design-system/gds/-/pipelines)
44
-
45
- ### 4. Once the [deploy](https://git.tmaws.io/global-design-system/gds/-/pipelines) has been successful, update the Jira issues to reflect their "done" status
46
-
47
- You'll notice that each Jira issue ID is a hyperlink in your release notes. You should open all of these in new tabs.
48
- For each Jira issue, click "Workflow > Done" to resolve the issue. Set the "resolution" to "completed" and in the comment, add something along the lines of "Deployed in gds release: [link to the release on GitLab]".
49
- Don't resolve any Jira issues until you're sure the deploy was successful. "Done" means tagged, not merged.
50
- You're done! Now you can get back to work!
51
-
52
- ## How to import GDS changes into your repo
53
-
54
- Once the tag is created, the pipeline will run which includes the step to publish to npm. After that, you can use the tag number just created to bump the version in your repo's `package.json`, subsequently run:
55
-
56
- `npm update <packagename>`
57
-
58
- So, in our case:
59
-
60
- ```bash
61
- npm update @ticketmaster/global-design-system
62
- ```
63
-
64
- Now you should have access to the changes and can make a MR for your repo.
65
-
66
- ---
67
-
68
- ## Releasing a hotfix
69
-
70
- This guide is for you if you want to cherrypick some commits instead of releasing everything inside the master branch.
71
-
72
- ### 1. Checkout the latest tag you want to branch off from
73
-
74
- ```bash
75
- git checkout <tag-name>
76
- ```
77
-
78
- ### 2. Create a new branch from the tag and make sure you name it with the correct semantic versioning pattern
79
-
80
- ```bash
81
- git checkout -b release/<patched-tag-name>
82
- ```
83
-
84
- ### 3. Cherry-pick the commits or feature branches you want to add to the new release branch
85
-
86
- ```bash
87
- git cherry-pick <commit-id>
88
- # OR
89
- git cherry-pick <feature-branch-name>
90
- ```
91
-
92
- ### 4. Go to "Repository > Releases" in GitLab and click "New release"
93
-
94
- - Follow the same process as above for the usual tag, but instead of `master`, select the `release/<patched-tag-name>` branch in the “Create from” dropdown
95
-
96
- ### 5. Merge the release branch back into master after it has been deployed
97
-
98
- ---
99
-
100
- ## Releasing a canary version
101
-
102
- This guide is for you if you want to create a release to test your unmerged changes in a different project without affecting the latest stable GDS version for other consumers.
103
-
104
- This is overkill for small UI changes, but a good usecase is for testing bigger/riskier changes in a demo environment before officially releasing them.
105
-
106
- In this example, the current stable release: `19.0.0` and your current branch name: `GDS-22-your-work`
107
-
108
- ### 1. Go to "[Deployments > Releases](https://git.tmaws.io/global-design-system/gds/-/releases)" in GitLab and click "New release"
109
-
110
- ### 2. Create a new tag with the name of the canary version
111
-
112
- It must be in this format: `<stable version>-canary.<canary version>`
113
-
114
- In our case we want to make a minor release in the future, so we enter `19.1.0-canary.1`.
115
-
116
- **Note:** the format is important because the regex we use in the `publish` script is:
117
-
118
- ```yml
119
- # Get the npm tag from the version name (e.g. 7.0.0-canary.2 -> canary)
120
- - export NPM_TAG=$(echo $CI_COMMIT_TAG | sed -nE 's/.*-(.*)\.[0-9]+/\1/p')
121
- - npm publish --tag=${NPM_TAG:-latest}
122
- ```
123
-
124
- If it doesn't match, it will create an unwanted stable tag.
125
-
126
- ### 3. Select the branch where you make the release from (not master)
127
-
128
- In this case, we select `GDS-22-your-work`.
129
-
130
- ### 4. Paste the release notes into the tag message and Release notes fields as usual
131
-
132
- ### 5. Click "Create release"
133
-
134
- ### 6. Check all went well
135
-
136
- Run this command where you have the `npmrc` file:
137
-
138
- ```sh
139
- npm view @ticketmaster/global-design-system
140
- ```
141
-
142
- You should see something like this:
143
-
144
- ```sh
145
- dist tags:
146
- canary: 19.1.0-canary.1 latest: 19.0.0
147
- ```
148
-
149
- **Note:** It is important that the `latest` tag is not the `canary` tag.
150
-
151
- ### 7. You can now install the canary version in your project with:
152
-
153
- ```sh
154
- npm i @ticketmaster/global-design-system@canary
155
- ```