figmatk 0.0.16 → 0.0.18

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.
@@ -13,7 +13,7 @@
13
13
  {
14
14
  "name": "figmatk",
15
15
  "description": "Swiss Army Knife for Figma Files (.deck)",
16
- "version": "0.0.16",
16
+ "version": "0.0.18",
17
17
  "author": {
18
18
  "name": "FigmaTK Contributors"
19
19
  },
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "figmatk",
3
- "version": "0.0.16",
3
+ "version": "0.0.18",
4
4
  "description": "Create and edit Figma Slides .deck files programmatically — no Figma API required",
5
5
  "author": {
6
6
  "name": "FigmaTK Contributors"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "figmatk",
3
- "version": "0.0.16",
3
+ "version": "0.0.18",
4
4
  "description": "Figma Toolkit — Swiss-army knife CLI for Figma .deck and .fig files",
5
5
  "type": "module",
6
6
  "bin": {
@@ -6,7 +6,7 @@ description: >
6
6
  clone or remove slides, or produce a .deck file for Figma Slides.
7
7
  Powered by FigmaTK under the hood.
8
8
  metadata:
9
- version: "0.0.16"
9
+ version: "0.0.18"
10
10
  ---
11
11
 
12
12
  # Figma Slides Creator
@@ -30,6 +30,12 @@ To let the user view the result: tell them to **open the file in Figma Desktop**
30
30
 
31
31
  ---
32
32
 
33
+ ## File locations — always use /tmp
34
+
35
+ **All files go in `/tmp/`** — scripts, output decks, images, everything. Never write to the Desktop, Documents, Downloads, or any user directory. Never create intermediate notes or reference markdown files. Just build and save the deck.
36
+
37
+ ---
38
+
33
39
  ## Path A — Create from Scratch (High-Level API)
34
40
 
35
41
  Use this when the user wants a new presentation. Follow these steps **in order, every time, no exceptions**.
@@ -184,7 +190,32 @@ Use this when the user provides a `.deck` file to modify.
184
190
 
185
191
  ## Design Philosophy
186
192
 
187
- Every deck must look **intentionally designed**, not AI-generated.
193
+ Think like a **professional PowerPoint designer**, not an AI generating slides. Every deck must feel like it was made by a human who spent a day on it.
194
+
195
+ ### Deck structure — use this template every time
196
+
197
+ A proper deck has a clear spine. Follow this slide order:
198
+
199
+ | # | Slide type | Purpose |
200
+ |---|-----------|---------|
201
+ | 1 | **Title** | Dark bg, big title, subtitle, presenter name |
202
+ | 2 | **Agenda / Overview** | 3–5 bullet topics, light bg |
203
+ | 3–N | **Content slides** | Vary layout each slide — see below |
204
+ | N+1 | **Section divider** (optional) | Bold colour block to signal a new chapter |
205
+ | Last | **Closing / CTA** | Dark bg mirrors title slide — "Thank you", next steps, contact |
206
+
207
+ The title and closing slides must use the **same dark background** — this creates the "sandwich" effect that makes decks feel complete.
208
+
209
+ ### Consistent visual motif — pick one and use it on every slide
210
+
211
+ Choose one repeating element and place it consistently across all content slides:
212
+
213
+ - **Top accent bar**: `addRectangle(0, 0, 1920, 8, { fill: hex('#...') })` — full-width coloured strip at top
214
+ - **Left colour panel**: tall rectangle on the left third, text floats right
215
+ - **Corner badge**: small filled circle or square in bottom-right with slide number or logo
216
+ - **Bottom rule**: thin full-width line at y=1040
217
+
218
+ Without a motif, slides look unrelated. With one, the deck feels designed.
188
219
 
189
220
  ### Colour
190
221
 
@@ -203,18 +234,27 @@ Every deck must look **intentionally designed**, not AI-generated.
203
234
  | Ocean | `'Blue'` | `hex('#21295C')` | `'White'` |
204
235
  | Minimal | `'White'` | `hex('#36454F')` | `'Black'` |
205
236
 
206
- ### Layout
237
+ ### Layout — vary every slide
238
+
239
+ Each content slide should use a **different layout type**. Never repeat the same structure back-to-back.
207
240
 
208
- - Every slide needs at least **one visual element** — shape, image, SVG, or table.
209
- - **Vary layouts** — never repeat the same structure slide after slide.
210
- - Carry one visual motif through every slide (coloured accent bar, icon circles, etc.).
241
+ | Layout | When to use |
242
+ |--------|------------|
243
+ | Two-column | Comparison, pros/cons, text + image |
244
+ | 2×2 or 2×3 grid | Features, icons, categories |
245
+ | Large stat callout | One big number + explanation |
246
+ | Half-background image | Photo-rich slides |
247
+ | Timeline / steps | Process, history, roadmap |
248
+ | Icon + text rows | Lists that need visual weight |
249
+ | Full-bleed image | Impact moment, section break |
211
250
 
212
- **Layout options:** two-column, icon+text rows, 2×2/2×3 grid, large stat callout, half-background image, timeline/steps.
251
+ Every slide needs at least **one visual element** shape, image, SVG, or table. No text-only slides.
213
252
 
214
253
  ### Typography
215
254
 
216
- - Left-align body text. Centre only titles.
255
+ - Left-align body text. Centre only titles on title/closing slides.
217
256
  - Minimum 64px margin from slide edges. 24–48px between content blocks.
257
+ - Use `Header 2` or `Header 3` for slide titles on content slides (not `Title` — that's for the title slide only).
218
258
 
219
259
  ### Never do
220
260
 
@@ -223,6 +263,7 @@ Every deck must look **intentionally designed**, not AI-generated.
223
263
  - Use accent lines under slide titles (hallmark of AI-generated slides)
224
264
  - Text-only slides
225
265
  - Low-contrast text against background
266
+ - Skip the closing slide — it makes the deck feel unfinished
226
267
 
227
268
  ---
228
269