designsource 0.2.0 → 0.2.1

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.
Files changed (2) hide show
  1. package/README.md +14 -7
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -94,17 +94,24 @@ pnpm --filter designsource start -- create my-app --api http://localhost:3001
94
94
 
95
95
  ## Publishing
96
96
 
97
- Manual, by the maintainer, from this folder. Nothing in the repo publishes.
97
+ By the maintainer, through GitHub Actions with npm trusted publishing: no npm token exists anywhere; npm accepts the release because GitHub vouches for the repository and workflow that built it. Nothing publishes on an ordinary push or merge. (npm attaches a provenance attestation only when the source repository is public, so while this one is private the releases carry none.)
98
98
 
99
- 1. `npm login` (npm requires 2FA to publish).
100
- 2. `pnpm version patch|minor` — every publish needs a bump.
101
- 3. `pnpm publish --dry-run --access public` and check the tarball is `dist/index.js`, `LICENSE`, `README.md`, `package.json`. `prepublishOnly` rebuilds `dist/` first, so a stale or missing build cannot ship.
102
- 4. `pnpm publish --access public`.
103
- 5. Verify from an empty folder: `npx designsource@latest --help`.
99
+ 1. Bump the version in `package.json` (`pnpm version patch|minor` here) and merge to `main`. Every publish needs a bump.
100
+ 2. Rehearse, optionally: Actions → "Release designsource" → Run workflow with dry run on. It installs, builds, tests and packs without publishing.
101
+ 3. Tag the merge commit `designsource@<version>` and push the tag:
102
+
103
+ ```sh
104
+ git tag designsource@0.3.0 && git push origin designsource@0.3.0
105
+ ```
106
+
107
+ The workflow (`.github/workflows/release-designsource.yml`) refuses a tag that does not match `package.json`, runs the tests (which build `dist/` first), publishes, then installs the published version from npm and runs `--help` against it.
108
+ 4. Check the npm page shows the new version.
109
+
110
+ One-time setup, done on npmjs.com: package settings → Trusted publishing → GitHub Actions, repository `KaroMourad/design-system`, workflow `release-designsource.yml`, no environment. Publishing from a laptop still works (`npm login`, `pnpm publish --access public` from this folder; `prepublishOnly` rebuilds `dist/`), but it needs your npm login and 2FA.
104
111
 
105
112
  The README's images live in the web app at `apps/web/public/designsource/` and are served from `designsource.app`; ship image changes there before the npm publish that references them. Their sources are in `assets/` here (`cover.html`, `make-gif.mjs`).
106
113
 
107
- `create-ds-app` was this package's first name (0.1.x). It is deprecated on npm, pointing here: `npm deprecate create-ds-app@"*" "Moved to designsource: npx designsource create my-app"`.
114
+ `create-ds-app` was this package's first name (0.1.x, September 2026). It was deleted from npm the day after `designsource` shipped; nothing points at it any more.
108
115
 
109
116
  ## License
110
117
 
package/package.json CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "designsource",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "The DS source CLI: add a design system to an existing app (integrate) or start a new Next.js project from it (create) — tokens, every component and your mockup page.",
5
5
  "license": "MIT",
6
6
  "repository": {
7
7
  "type": "git",
8
- "url": "https://github.com/KaroMourad/design-system.git",
8
+ "url": "git+https://github.com/KaroMourad/design-system.git",
9
9
  "directory": "apps/designsource"
10
10
  },
11
11
  "homepage": "https://designsource.app",