makeables 0.1.0 → 0.3.0

package/README.md

@@ -3,10 +3,10 @@
 Design cards and badges with editable layers, live materials and your coding agent. Requires Node.js 22+.
 
 ```sh
-npx skills add crafter-station/makeables-community --skill makeables
+npx skills add crafter-station/makeables-community --skill makeables --global
 ```
 
-The skill checks for Makeables 0.1.0+ and installs or updates the CLI when authorized. To set up the CLI directly:
+The skill checks for Makeables 0.2.0+ and installs or updates the CLI when authorized. To set up the CLI directly:
 
 ```sh
 npm install --global makeables
@@ -40,6 +40,7 @@ makeables skills get cards
 makeables skills get badges
 makeables skills get design
 makeables skills get images
+makeables skills get wallet
 makeables skills get core --full
 makeables doctor --json
 ```
@@ -81,13 +82,13 @@ Most commands return `{ok:true,version,data,nextSteps}` or `{ok:false,version,er
 
 ## Publish with your agent
 
-Your agent closes the first preview with “Want to change anything or publish it?” It saves a portable bundle containing the design, participant, portrait and artwork before publication:
+For badges, your agent closes the first preview with “Want to change anything or publish it?” It saves a portable bundle containing the design, participant, portrait and artwork before publication:
 
 ```sh
-makeables studio save --url "$MAKEABLES_URL" --out badge.badge.json
-makeables publish --file badge.badge.json --dry-run
-makeables publish --file badge.badge.json --yes
-makeables publish status --file badge.badge.json
+makeables studio save --url "$MAKEABLES_URL" --out badge.makeables.json
+makeables submit --file badge.makeables.json --dry-run
+makeables submit --file badge.makeables.json --yes
+makeables submit status --file badge.makeables.json
 ```
 
 `--yes` means you approved sharing this exact badge, including its photo, name and editable design. Publication runs directly from the bundle, even after the editor closes. Retries reuse the same operation and return the same public URL.
@@ -99,3 +100,66 @@ Creation, local saving, editing and export remain anonymous. `--dry-run` validat
 The existing editor tools still support author-only updates and withdrawal. Your agent verifies the public link before calling publication complete.
 
 The package and command are `makeables`. Proprietary software by Crafter Station; see LICENSE for the terms of use.
+
+
+## Cards from references and Wallet
+
+Makeables 0.2.0 includes the complete reference workflow in `skills get cards`.
+Import supported original SVG elements as layers, or keep a supplied raster as
+an image layer. Local `image` tools prepare, measure, selectively trace, rotate
+and compare references without a private checkout. Only tracing needs optional
+`potrace` on PATH.
+
+```sh
+makeables new card --file artwork.svg --out card.json
+makeables validate --file artwork.svg --out preview.png
+makeables image compare --file artwork.svg --ref reference.png --out comparison.png
+```
+
+At a ready card preview, the agent offers to keep iterating, submit to the
+gallery, or install the artwork on the phone. Cards and badges share `/submit` and `makeables submit`;
+`publish` is an alias. Editable layers, both faces and assets stay together. Choosing installation
+loads `makeables skills get wallet`.
+
+```sh
+makeables wallet setup
+makeables wallet prep --file card.json --out wallet-preview
+makeables wallet list
+makeables wallet apply --file card.json --card c-SELECTION --yes
+makeables wallet backups
+makeables wallet restore --backup b-BACKUP --yes
+```
+
+Wallet runs on a Mac with a USB-connected iPhone. Setup downloads a versioned,
+checksum-verified companion containing the runtime, native bridges and artwork
+exporter; no source checkout or developer toolchain is required. `apply` changes
+the artwork of a selected existing card; `restore` removes that custom design
+using verified issuer artwork. Neither provisions nor deletes payment cards.
+
+Original backups live privately in `~/Documents/Makeables/Wallet Backups/`;
+operational state lives in `~/Library/Application Support/Makeables/Wallet/`.
+Updates do not remove these files. `wallet doctor` reports the companion's state
+without touching a device. `MAKEABLES_WALLET_HELPER` selects a compatible local
+companion for development; `MAKEABLES_WALLET_HOME` and `MAKEABLES_WALLET_BACKUPS`
+override its private storage locations.
+
+Wallet artwork changes use experimental, unofficial device services. Apply has
+been tested on a Wallet card; restoration of an actual Wallet card remains
+unverified. Keep the original backups and inspect the guide before device work.
+
+## Share any design
+
+```sh
+makeables submit --file card.json --dry-run
+makeables submit --file card.json --yes --credit "Your name"
+makeables submit status --file card.json --credit "Your name"
+```
+
+`submit` accepts layered JSON, original card SVGs, legacy badge bundles and
+portable `.makeables.zip` or `.makeables.json` packages. `publish` is the same
+command. In the editor, **Submit** opens the shared preview and credits form;
+no manual ZIP assembly is necessary. Sign-in preserves the draft. Submissions
+are private while pending and become public after approval. Both products are
+reviewed at `/admin`, available in the user menu for database-authorized admins.
+
+See [the portable format](../../docs/submission-format.md) for package limits and assets.