softr-vibe-coding 1.2.0 → 1.3.1

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to this skill are documented here. Versions follow [Semantic Versioning](https://semver.org/), and the format draws from [Keep a Changelog](https://keepachangelog.com/).
+
+Entries from 1.3.1 onward are generated automatically from git commit subjects between version bumps (see `.github/workflows/publish.yml`). Entries before 1.3.1 were backfilled by hand from the existing commit history.
+
+## [1.3.1] - 2026-05-21
+- (no notable changes)
+
+## [1.3.0] - 2026-05-21
+- Cross-link Airtable data source ↔ automation scripts (`datasources/airtable.md` and `datasources/writing.md` now point to `references/airtable-automations.md`)
+- Refresh README's "What's Included" tree: add `airtable-automations.md` and `common-patterns.md`, update stale line counts, fix version badge
+
+## [1.2.0] - 2026-05-20
+- Add `building-design-md` companion section to SKILL.md and README
+- Add install notes for the two-skill brand-to-blocks workflow
+
+## [1.1.0] - 2026-05-20
+- Package as an npm CLI: `npx softr-vibe-coding@latest init` installs into `~/.claude/skills/softr-vibe-coding/` and wires a `SessionStart` hook for auto-updates
+- Add `references/airtable-automations.md` — Airtable Automation Scripts, Scripting Extension, and Airtable formulas (with `input.config()` / `input.secret()` rules, the `output` API divergence between environments, `updateRecordsAsync` duplicate-id rejection, batch-50 cap, field-ID-not-name discipline)
+- Add detail-page back-button rule to placement Q&A; add Block Placement & Page Spacing section to SKILL.md; add brand-source detection step (DESIGN.md handoff)
+- Document `useRecordUpdate.mutate()` parser requirements: method must be `.mutate()` not `.mutateAsync()`, payload must be nested `{ recordId, fields: {...} }` not flat
+- Document `useNavigationSetting`'s `openIn` enum (`SELF` / `TAB` / `MODAL` only) and the canonical `<NavigationAction>` + `<Button asChild>` pattern, with per-action-type config requirements
+- Document `OPEN_CHAT` data-source requirement (button-only helper blocks with no data source cause `chat/prepare` 500s)
+- Document Global Data Restrictions as a separate permissions layer above block-level visibility
+- Add anti-patterns: sub-components defined inside `Block()` (focus loss), brand fonts inside shadow DOM (need inline application), double-painted background on block wrapper, `document.getElementById` / `querySelector` failing silently inside blocks
+- Verify and document Airtable column-name-only constraint with rename mitigations
+- Codify three common Vibe Coding patterns and the network-inspector schema-discovery + AI-paste workflow
+- Verify public Softr Database REST API write path
+- Flatten repo layout: move `SKILL.md` and skill content to repo root for direct `~/.claude/skills/softr-vibe-coding/` consumption
+- Add `.gitignore` covering sensitive and noise files
+
+## [1.0.0] - 2026-04-14
+- Initial release of the Softr Vibe Coding Block Claude Skill
+- Full SKILL.md workflow, ui-ux-guidelines.md, references (helper-blocks, advanced-integrations, anti-patterns, quick-reference), data source guides for all 14 supported sources

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.1",
   "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"
@@ -12,7 +12,8 @@
     "references/",
     "datasources/",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "keywords": [
     "claude",