You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
// Don't mess with things that don't have .spectrum-Heading in them
305
+
return selector;
306
+
},
307
+
}),
308
+
],
309
309
};
310
310
```
311
311
@@ -322,71 +322,53 @@ yarn install
322
322
yarn start
323
323
```
324
324
325
-
Your `dist/` folder should now have a local copy of the Spectrum CSS docs and minimal CSS files, and your browser should be open with the project's preview site. Editing any of the `.css` or the `.stories.js` files in `components/*` will update the project documentation and live reload in your browser.
325
+
Your `dist/` folder should now have a local copy of the compiled CSS files, and your browser should be open with the project's preview site. Editing any of the `.css` or the `.stories.js` files in `components/*` will update the project documentation and live reload in your browser.
326
326
327
-
**Important:** Ensure you have Node.js > 14 installed or the build system will not run. Node.js > 16.x is preferred.
327
+
**Important:** Ensure you have Node.js >= 14 installed or the build system will not run. Node.js 16.x is preferred.
328
328
329
-
This project is leveraging caching from [Nx](https://nx.dev/) to speed up the build process. If you are seeing unexpected results, you can clear the cache by running `yarn nx clean` or `yarn nx run-many --target clean --all`.
329
+
This project is leveraging caching from [Nx](https://nx.dev/) to speed up the build process. If you are seeing unexpected results, you can clear the cache by running `yarn nx reset`.
330
330
331
331
To spin up the local development environment ([Storybook](https://storybook.js.org/docs/web-components/get-started/introduction)) without first building the components, use: `SKIP_BUILD=true yarn start` as `yarn start` alone will start from a clean build.
332
332
333
333
### Documentation site
334
334
335
335
#### Local documentation site
336
336
337
-
Building the project will build and launch the project documentation site in your browser automatically.
338
-
339
-
See [site generation](site/README.md) for more information.
340
-
341
-
#### Generating and deploying external documentation site
342
-
343
-
Checkout `nextjs` branch, pull, and install dependencies.
344
-
345
-
```shell
346
-
git checkout nextjs
347
-
git pull
348
-
yarn install
349
-
```
350
-
351
-
Update `yml` data from main
337
+
After installing the project, you can spin up a local view of the documentation site with:
352
338
353
339
```shell
354
-
yarn importdata
340
+
yarn dev
355
341
```
356
342
357
-
Run `prep` script to build the static site locally
343
+
See [site generation](site/README.md) for more information. This is being imminently updated to 11ty so it's advised to hold off opening any pull requests to change the site until that is complete.
358
344
359
-
```shell
360
-
yarn prep
361
-
```
362
-
363
-
Commit changes
364
-
365
-
```shell
366
-
git commit -am '<message here>'
367
-
```
345
+
#### Generating and deploying external documentation site
368
346
369
-
Deploy
347
+
To generate the documentation site, run the following command:
370
348
371
349
```shell
372
-
yarn deploy
350
+
yarn release:site
373
351
```
374
352
375
-
Push changes to `nextjs` branch
376
-
377
-
```shell
378
-
git push origin nextjs
379
-
```
353
+
This will generate the documentation site in the `dist/` folder and push that content to gh-pages.
380
354
381
355
### CLI
382
356
383
357
The following tasks are available:
384
358
385
-
-`yarn build:all` - Performs a build of all components, documentation site, and storybook
386
-
-`yarn build` - Performs a build of all components
387
-
-`yarn dev` - Performs a component build, runs storybook, and serves the documentation on the default port (3000), then starts watching components and website files
388
-
-`yarn clean` - Cleans all output files for the project and all components
389
-
-`yarn watch` - Assuming a build has already been performed, re-starts starts watching components and website files. Presumes a browser is already open to your locally served docs
359
+
-`yarn build:all`: Performs a build of all components, documentation site, and storybook
360
+
-`yarn build`: Performs a build of all components
361
+
-`yarn build:components`: Builds components in parallel; uses cache
-`yarn clean`: Cleans all output files for the project and all components
365
+
-`yarn ci:storybook`: Builds storybook & dependencies (all components) for CI
366
+
-`yarn clean:components`: Deletes compiled assets for all component folders
367
+
-`yarn clean:preview`: Deletes the storybook compiled assets
368
+
-`yarn dev` - Performs a component build, runs storybook in the background on port (3000), then builds the documentation site, opening the content from `dist/`
369
+
-`yarn lint`: Lints packages and css for components
370
+
-`yarn start`: Triggers storybook build and dev server
371
+
-`yarn watch` - Assuming a build has already been performed, re-starts starts watching components and website files; Presumes a browser is already open to your locally served docs
390
372
391
373
---
392
374
@@ -396,41 +378,32 @@ The following tasks are available:
396
378
397
379
Releasing individual components is handled by Lerna. When any component or its dependencies change, Lerna will queue that component (and all of its dependents) up for a release.
398
380
399
-
To release everything that has changed, simply run:
381
+
To release everything that has changed, run:
400
382
401
383
```shell
402
384
yarn release
403
385
```
404
386
405
-
Version numbers are automatically determined, changelogs generated, and packages published.
387
+
A build of all components is run, then a `lerna publish` command is fired (with settings to prevent publishing private packages). Version numbers are automatically determined, changelogs generated, and packages published to npm.
406
388
407
-
### Releasing the website
389
+
<details>
390
+
<summary>Prereleases</summary>
408
391
409
-
After performing a release, run the following command to release the website:
392
+
Before changes are considered production-ready, a prerelease tag might be created to facilitate testing in downstream projects.
410
393
411
-
```shell
412
-
yarn release:docs
413
-
```
394
+
**Before starting, ensure that you're working from a branch other than `main`.**
414
395
415
-
### Publishing prereleases
396
+
Commit changes using the typical conventional commit syntax.
416
397
417
-
Occasionally, it can be helpful for our subscribers to test CSS changes before they're considered ready to be part of a stable release. To facilitate this, we can publish prerelease versions.
build the affected package(s) locally, then publish them to npm. An npm task for cleaning, building, and beta publishing is available, and it can be run via the following command: `yarn release:beta`. This command will perform a full `clean` (via the `clean` task), a full `build` (via the `build` task), and will attempt to bump the version numbers in the affected package(s) (via `lerna publish --conventional-prerelease --preid beta --pre-dist-tag beta --no-private`).
420
405
421
-
- First, be sure that you're working on a branch other than `main`.
422
-
- Once your change(s) are ready to be committed, be aware of the severity of the change(s), and be sure to author your commit message so that Lerna understands how to increase the version number(s) of the affected components.
423
-
- Once your changes are committed, you **must** build the affected package(s) locally **before** publishing them to npm. An npm task for cleaning, building, and beta publishing is available, and it can be run via the following command: `yarn release:beta-from-package`. This command will perform a full `clean` (via the `clean` task), a full `build` (via the `build` task), and will attempt to bump the version numbers in the affected package(s) (via `lerna publish --conventional-prerelease --preid beta --pre-dist-tag beta --no-private`).
424
406
- Depending on the severity of your change(s), and before publishing to npm, Lerna should show a preview of the affected package version numbers that look something like: `@spectrum-css/tag: 3.3.8 => 3.3.9-beta.0`. Additionally, at this time, Lerna will ask if you would like to continue with publishing the changes or cancel.
425
407
- Selecting `y` to publish will publish the affected package(s) to npm.
426
408
427
-
### Manual prerelease versioning & publishing
428
-
429
-
Occasionally, you may want to run a prerelease for an individual package and skip a version bump for consuming packages. It's possible to manually change a package's version number to achieve this.
430
-
431
-
- For the package that you want to prerelease, manually alter the version number in the package's `package.json` file.
432
-
- For example, let's say you'd like to release a `beta` version of the Switch component. In the Switch's `package.json`, manually change the `version` number from its current number (`"version": "1.0.23"`) to the next appropriate semver version number (`"version": "2.0.0-beta.0"`).
433
-
- Save your changes, and commit them with the appropriate conventional commit-style commit message: `chore(switch): manual version bump for beta release` or something similar.
434
-
- You **must** run a build **before** continuing with the prerelease. An npm task for cleaning, building, and beta publishing is available, and it can be run via the following command: `yarn release:beta-from-package`. This command will perform a full `clean` (via the `clean` task), a full `build` (via the `build` task), and will attempt to publish the package (via `lerna publish --conventional-prerelease --preid beta --pre-dist-tag beta --no-private`).
435
-
- Depending on the severity of your change(s), and before publishing to npm, Lerna should show a preview of the affected package version number that looks something like: `@spectrum-css/switch: 1.0.23 => 2.0.0-beta.0`. Additionally, at this time, Lerna will ask if you would like to continue with publishing the changes or cancel.
436
-
- Selecting `y` to publish will publish the affected package(s) to npm.
0 commit comments