softr-vibe-coding 1.1.0 → 1.3.0

package/README.md

@@ -3,7 +3,7 @@
 > Turn Claude into a Softr Vibe Coding expert — generate production-ready JSX blocks with polished UI, correct data fetching, and all 14 Softr data sources supported out of the box.
 
 ![Claude Code Skill](https://img.shields.io/badge/Claude_Code-Skill-blue)
-![Version](https://img.shields.io/badge/version-1.1.0-green)
+![Version](https://img.shields.io/badge/version-1.3.0-green)
 ![License](https://img.shields.io/badge/license-MIT-lightgrey)
 
 > **UNOFFICIAL** — This is a community-maintained Claude skill. It is not affiliated with, endorsed by, or officially supported by Softr. Use as-is.
@@ -84,6 +84,27 @@ Build me a Softr Vibe Coding block that shows a team directory with cards
 
 ---
 
+## Companion skill — `building-design-md`
+
+This skill is **Step 2** of a two-skill brand-to-blocks pipeline:
+
+```
+New client → building-design-md (brand → DESIGN.md) → softr-vibe-coding (DESIGN.md → JSX blocks) → shipped Softr app
+```
+
+The upstream skill is [`building-design-md`](https://github.com/leo-softr/design-md-extractor-skill), which extracts a brand foundation (colors, typography, voice) from a website URL or brand guide into a portable `DESIGN.md` file. When that file exists in your project folder, this skill picks it up automatically and applies the brand tokens throughout every block it generates — no re-asking about colors or fonts.
+
+**Install both for the full workflow:**
+
+```bash
+npx building-design-md@latest init
+npx softr-vibe-coding@latest init
+```
+
+Both auto-update on every Claude Code session. Skip the first one if you only want default Softr styling.
+
+---
+
 ## Updating
 
 **If you used the recommended `npx ... init` install**, updates are automatic — the SessionStart hook pulls the latest published version on every Claude Code session, so you're always at most one session behind the latest release.
@@ -147,16 +168,24 @@ softr-vibe-coding/
 │                                     # spacing, motion, accessibility, AI slop checklist
 │
 ├── references/                       # Advanced patterns (loaded on demand)
-│   ├── helper-blocks.md              # Cross-block communication (327 lines)
+│   ├── helper-blocks.md              # Cross-block communication (370 lines)
 │   │                                 # Invisible helper blocks, window globals,
 │   │                                 # CustomEvent, useWindowData hook, breadcrumbs,
 │   │                                 # saved views, companion field helpers
+│   ├── airtable-automations.md       # Airtable automation scripting (350 lines)
+│   │                                 # "Run a script" automation action vs.
+│   │                                 # Scripting Extension, cross-table cascades,
+│   │                                 # batch update gotchas, field-ID discipline,
+│   │                                 # Airtable formulas
 │   ├── advanced-integrations.md      # Shadow DOM CSS isolation (69 lines)
 │   │                                 # Leaflet, Mapbox, TinyMCE, Quill, FullCalendar
-│   ├── anti-patterns.md              # Categorized violation catalog (69 lines)
+│   ├── anti-patterns.md              # Categorized violation catalog (86 lines)
 │   │                                 # Data access, mutations, hooks, layout,
 │   │                                 # permissions, helper blocks
-│   └── quick-reference.md            # Syntax cheat sheet (156 lines)
+│   ├── common-patterns.md            # Small reusable patterns (102 lines)
+│   │                                 # localStorage cross-page state,
+│   │                                 # clipboard copy button
+│   └── quick-reference.md            # Syntax cheat sheet (207 lines)
 │                                     # Imports, hook signatures, mutation shapes,
 │                                     # field mapping, component skeleton
 │

package/SKILL.md

@@ -40,7 +40,7 @@ You generate complete, production-ready Softr Vibe Coding blocks as JSX files. A
    - **If `./DESIGN.md` is NOT found:** Tell the user:
 
      > "No DESIGN.md found in this project. Three options:
-     > A. **Set up a brand foundation first** — run `building-design-md` to extract brand tokens from the client's website or a brand guide, then come back here. (Recommended for client work.)
+     > A. **Set up a brand foundation first** — use the `building-design-md` skill to extract brand tokens from the client's website or a brand guide, then come back here. (Recommended for client work. Not installed? Run `npx building-design-md@latest init` in your terminal.)
      > B. **Quick brand override** — paste the brand's primary color, accent color, and font name now. I'll apply just those.
      > C. **Use the default Softr style** — primary `#386AF5`, accent `#FCB500`, Inter font."
 

package/datasources/airtable.md

@@ -1,5 +1,7 @@
 # Airtable
 
+> **Looking for Airtable Automation Scripts, Scripting Extension, or Airtable formulas?** This page covers the **Softr data source** integration (read/write from a Vibe Coding block). For Airtable-side scripts and formula fields — including cross-table cascades triggered by record changes — see [../references/airtable-automations.md](../references/airtable-automations.md).
+
 ## Overview
 Popular spreadsheet-database hybrid used as a data source for Softr. Requires a Basic plan or higher in Softr.
 

package/datasources/writing.md

@@ -237,7 +237,10 @@ Plain string. To clear a value, both `null` and `""` work for Softr Database tex
 
 ## Cross-Table Operations
 
-`useRecordCreate`, `useRecordUpdate`, and `useRecordDelete` only work with the block's configured datasource. To write to a different table, use the **Softr Database REST API** via `fetch()`:
+`useRecordCreate`, `useRecordUpdate`, and `useRecordDelete` only work with the block's configured datasource. Two paths to write across tables:
+
+- **For Airtable backends** — usually cleanest to write to the block's own table and let an Airtable automation script handle the cascade. See [../references/airtable-automations.md](../references/airtable-automations.md). Keeps the block simple, avoids exposing an API key in the browser, and lets cross-table logic live next to the data.
+- **Softr Database REST API via `fetch()`** — the only option for non-Airtable sources, and the right choice when an automation cycle would be too slow. Details below.
 
 **Base URL:** `https://tables-api.softr.io/api/v1/databases/{databaseId}/tables/{tableId}/records`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "softr-vibe-coding",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Claude Code skill for generating production-ready Softr Vibe Coding blocks (JSX). Installs into ~/.claude/skills/ and auto-updates on each Claude Code session.",
   "bin": {
     "softr-vibe-coding": "./bin/cli.js"