softr-vibe-coding 1.2.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.
@@ -168,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/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.2.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"