makeables 0.2.0 → 0.4.0
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 +39 -13
- package/dist/assets/badge/stickers/fonts/LilitaOne-Regular.ttf +0 -0
- package/dist/assets/badge/stickers/fonts/OFL.txt +94 -0
- package/dist/cli.js +2035 -699
- package/package.json +5 -4
package/README.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# Makeables
|
|
2
2
|
|
|
3
|
-
Design cards and
|
|
3
|
+
Design cards, badges and stickers with editable layers, live materials and your coding agent. Requires Node.js 22+.
|
|
4
4
|
|
|
5
5
|
```sh
|
|
6
6
|
npx skills add crafter-station/makeables-community --skill makeables --global
|
|
7
7
|
```
|
|
8
8
|
|
|
9
|
-
The skill checks for Makeables 0.
|
|
9
|
+
The skill checks for Makeables 0.4.0+ and installs or updates the CLI when authorized. To set up the CLI directly:
|
|
10
10
|
|
|
11
11
|
```sh
|
|
12
12
|
npm install --global makeables
|
|
@@ -15,7 +15,7 @@ makeables skills get core
|
|
|
15
15
|
|
|
16
16
|
Ask: “Use the makeables guide. Make an experimental badge from my photo at ~/Pictures/me.png. Show me both sides, then let’s refine it here.”
|
|
17
17
|
|
|
18
|
-
For personalized badges, the guide asks for a photo if one is missing and asks before installing agent-browser for visual inspection. Cards do not need a portrait. It offers ai-cli only when a requested image transformation needs it. Image generation uses your own AI Gateway credentials and credits.
|
|
18
|
+
For personalized badges, the guide asks for a photo if one is missing and asks before installing agent-browser for visual inspection. Cards and stickers do not need a portrait. It offers ai-cli only when a requested image transformation needs it. Image generation uses your own AI Gateway credentials and credits.
|
|
19
19
|
|
|
20
20
|
## Cards from the terminal
|
|
21
21
|
|
|
@@ -38,6 +38,7 @@ Use `makeables studio start --product card` for live WebGPU materials and lighti
|
|
|
38
38
|
makeables skills get core
|
|
39
39
|
makeables skills get cards
|
|
40
40
|
makeables skills get badges
|
|
41
|
+
makeables skills get stickers
|
|
41
42
|
makeables skills get design
|
|
42
43
|
makeables skills get images
|
|
43
44
|
makeables skills get wallet
|
|
@@ -55,7 +56,7 @@ makeables studio start
|
|
|
55
56
|
|
|
56
57
|
This opens your operating system’s default browser. An agent with a built-in browser panel should use `makeables studio start --no-open --json` and open the returned URL there. Keep the process running and reuse that tab while iterating.
|
|
57
58
|
|
|
58
|
-
The local preview embeds the real [badge editor](https://makeables.dev/make/badge)
|
|
59
|
+
The local preview embeds the real [badge editor](https://makeables.dev/make/badge) [card editor](https://makeables.dev/make/card) or [sticker editor](https://makeables.dev/make/sticker). Its local connection uses the same tools, revision checks and validation as native WebMCP. It works without native WebMCP in the preview browser. One tab owns a session; no separate browser-state synchronization is implied.
|
|
59
60
|
|
|
60
61
|
```sh
|
|
61
62
|
makeables studio tools --url "$MAKEABLES_URL" --json
|
|
@@ -82,18 +83,18 @@ Most commands return `{ok:true,version,data,nextSteps}` or `{ok:false,version,er
|
|
|
82
83
|
|
|
83
84
|
## Publish with your agent
|
|
84
85
|
|
|
85
|
-
For
|
|
86
|
+
For every product, your agent saves a complete portable package before submission. Badge packages also contain participant details and a portrait; cards and stickers do not need them:
|
|
86
87
|
|
|
87
88
|
```sh
|
|
88
|
-
makeables studio save --url "$MAKEABLES_URL" --out badge.
|
|
89
|
-
makeables
|
|
90
|
-
makeables
|
|
91
|
-
makeables
|
|
89
|
+
makeables studio save --url "$MAKEABLES_URL" --out badge.makeables.json
|
|
90
|
+
makeables submit --file badge.makeables.json --dry-run
|
|
91
|
+
makeables submit --file badge.makeables.json --yes
|
|
92
|
+
makeables submit status --file badge.makeables.json
|
|
92
93
|
```
|
|
93
94
|
|
|
94
|
-
`--yes` means you approved sharing this exact
|
|
95
|
+
`--yes` means you approved sharing this exact design and its included images and data. Submission runs directly from the package, even after the editor closes. Retries reuse the same operation and receipt. A pending receipt means private admin review; the design becomes public only after approval.
|
|
95
96
|
|
|
96
|
-
The first
|
|
97
|
+
The first submission opens Clerk device login in your default browser and continues automatically once you connect. The upload continues from the CLI. Subsequent submissions reuse the OS credential store. `makeables login --no-open` prints the verification link for a session browser; `makeables logout` revokes the connection. `MAKEABLES_TOKEN` supports existing OAuth access tokens in headless environments. Credentials never appear on stdout or in the local operation log.
|
|
97
98
|
|
|
98
99
|
Creation, local saving, editing and export remain anonymous. `--dry-run` validates the actual bundle without authentication or network calls. `MAKEABLES_DISABLE_PUBLISH=1` disables public writes. `MAKEABLES_STATE_DIR` overrides the local operation/receipt directory; keep it private. JSON progress events are on stderr; the final result and durable receipt are on stdout.
|
|
99
100
|
|
|
@@ -117,8 +118,8 @@ makeables image compare --file artwork.svg --ref reference.png --out comparison.
|
|
|
117
118
|
```
|
|
118
119
|
|
|
119
120
|
At a ready card preview, the agent offers to keep iterating, submit to the
|
|
120
|
-
gallery, or install the artwork on the phone. Cards
|
|
121
|
-
`
|
|
121
|
+
gallery, or install the artwork on the phone. Cards, badges and stickers share `/submit` and `makeables submit`;
|
|
122
|
+
`publish` is an alias. Editable layers, both faces and assets stay together. Choosing installation
|
|
122
123
|
loads `makeables skills get wallet`.
|
|
123
124
|
|
|
124
125
|
```sh
|
|
@@ -146,3 +147,28 @@ override its private storage locations.
|
|
|
146
147
|
Wallet artwork changes use experimental, unofficial device services. Apply has
|
|
147
148
|
been tested on a Wallet card; restoration of an actual Wallet card remains
|
|
148
149
|
unverified. Keep the original backups and inspect the guide before device work.
|
|
150
|
+
|
|
151
|
+
## Share any design
|
|
152
|
+
|
|
153
|
+
```sh
|
|
154
|
+
makeables submit --file card.json --dry-run
|
|
155
|
+
makeables submit --file card.json --yes --credit "Your name"
|
|
156
|
+
makeables submit status --file card.json --credit "Your name"
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
`submit` accepts layered JSON, original card SVGs, legacy badge bundles and
|
|
160
|
+
portable `.makeables.zip` or `.makeables.json` packages. `publish` is the same
|
|
161
|
+
command. In the editor, **Submit** opens the shared preview and credits form;
|
|
162
|
+
no manual ZIP assembly is necessary. Sign-in preserves the draft. Submissions
|
|
163
|
+
are private while pending and become public after approval. All three products are
|
|
164
|
+
reviewed at `/admin`, available in the user menu for database-authorized admins.
|
|
165
|
+
|
|
166
|
+
See [the portable format](../../docs/submission-format.md) for package limits and assets.
|
|
167
|
+
|
|
168
|
+
### Stickers
|
|
169
|
+
|
|
170
|
+
`makeables studio start --product sticker` opens the same Design Studio and CLI bridge.
|
|
171
|
+
`makeables new sticker --style good-energy --out sticker.json` creates the shared document.
|
|
172
|
+
Use `makeables skills get stickers` for material editing, PNG/JSON export and the common
|
|
173
|
+
`submit --dry-run` / consent / review lifecycle. Sticker packages contain a transparent
|
|
174
|
+
material preview and editable layers, with no participant data.
|
|
Binary file
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
Copyright (c) 2011 Juan Montoreano (juan@remolacha.biz),
|
|
2
|
+
with Reserved Font Name Lilita
|
|
3
|
+
|
|
4
|
+
This Font Software is licensed under the SIL Open Font License, Version 1.1.
|
|
5
|
+
This license is copied below, and is also available with a FAQ at:
|
|
6
|
+
http://scripts.sil.org/OFL
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
-----------------------------------------------------------
|
|
10
|
+
SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
|
|
11
|
+
-----------------------------------------------------------
|
|
12
|
+
|
|
13
|
+
PREAMBLE
|
|
14
|
+
The goals of the Open Font License (OFL) are to stimulate worldwide
|
|
15
|
+
development of collaborative font projects, to support the font creation
|
|
16
|
+
efforts of academic and linguistic communities, and to provide a free and
|
|
17
|
+
open framework in which fonts may be shared and improved in partnership
|
|
18
|
+
with others.
|
|
19
|
+
|
|
20
|
+
The OFL allows the licensed fonts to be used, studied, modified and
|
|
21
|
+
redistributed freely as long as they are not sold by themselves. The
|
|
22
|
+
fonts, including any derivative works, can be bundled, embedded,
|
|
23
|
+
redistributed and/or sold with any software provided that any reserved
|
|
24
|
+
names are not used by derivative works. The fonts and derivatives,
|
|
25
|
+
however, cannot be released under any other type of license. The
|
|
26
|
+
requirement for fonts to remain under this license does not apply
|
|
27
|
+
to any document created using the fonts or their derivatives.
|
|
28
|
+
|
|
29
|
+
DEFINITIONS
|
|
30
|
+
"Font Software" refers to the set of files released by the Copyright
|
|
31
|
+
Holder(s) under this license and clearly marked as such. This may
|
|
32
|
+
include source files, build scripts and documentation.
|
|
33
|
+
|
|
34
|
+
"Reserved Font Name" refers to any names specified as such after the
|
|
35
|
+
copyright statement(s).
|
|
36
|
+
|
|
37
|
+
"Original Version" refers to the collection of Font Software components as
|
|
38
|
+
distributed by the Copyright Holder(s).
|
|
39
|
+
|
|
40
|
+
"Modified Version" refers to any derivative made by adding to, deleting,
|
|
41
|
+
or substituting -- in part or in whole -- any of the components of the
|
|
42
|
+
Original Version, by changing formats or by porting the Font Software to a
|
|
43
|
+
new environment.
|
|
44
|
+
|
|
45
|
+
"Author" refers to any designer, engineer, programmer, technical
|
|
46
|
+
writer or other person who contributed to the Font Software.
|
|
47
|
+
|
|
48
|
+
PERMISSION & CONDITIONS
|
|
49
|
+
Permission is hereby granted, free of charge, to any person obtaining
|
|
50
|
+
a copy of the Font Software, to use, study, copy, merge, embed, modify,
|
|
51
|
+
redistribute, and sell modified and unmodified copies of the Font
|
|
52
|
+
Software, subject to the following conditions:
|
|
53
|
+
|
|
54
|
+
1) Neither the Font Software nor any of its individual components,
|
|
55
|
+
in Original or Modified Versions, may be sold by itself.
|
|
56
|
+
|
|
57
|
+
2) Original or Modified Versions of the Font Software may be bundled,
|
|
58
|
+
redistributed and/or sold with any software, provided that each copy
|
|
59
|
+
contains the above copyright notice and this license. These can be
|
|
60
|
+
included either as stand-alone text files, human-readable headers or
|
|
61
|
+
in the appropriate machine-readable metadata fields within text or
|
|
62
|
+
binary files as long as those fields can be easily viewed by the user.
|
|
63
|
+
|
|
64
|
+
3) No Modified Version of the Font Software may use the Reserved Font
|
|
65
|
+
Name(s) unless explicit written permission is granted by the corresponding
|
|
66
|
+
Copyright Holder. This restriction only applies to the primary font name as
|
|
67
|
+
presented to the users.
|
|
68
|
+
|
|
69
|
+
4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
|
|
70
|
+
Software shall not be used to promote, endorse or advertise any
|
|
71
|
+
Modified Version, except to acknowledge the contribution(s) of the
|
|
72
|
+
Copyright Holder(s) and the Author(s) or with their explicit written
|
|
73
|
+
permission.
|
|
74
|
+
|
|
75
|
+
5) The Font Software, modified or unmodified, in part or in whole,
|
|
76
|
+
must be distributed entirely under this license, and must not be
|
|
77
|
+
distributed under any other license. The requirement for fonts to
|
|
78
|
+
remain under this license does not apply to any document created
|
|
79
|
+
using the Font Software.
|
|
80
|
+
|
|
81
|
+
TERMINATION
|
|
82
|
+
This license becomes null and void if any of the above conditions are
|
|
83
|
+
not met.
|
|
84
|
+
|
|
85
|
+
DISCLAIMER
|
|
86
|
+
THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
87
|
+
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
|
|
88
|
+
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
|
|
89
|
+
OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
|
|
90
|
+
COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
|
|
91
|
+
INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
|
|
92
|
+
DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
93
|
+
FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
|
|
94
|
+
OTHER DEALINGS IN THE FONT SOFTWARE.
|