softr-vibe-coding 1.10.1 → 1.10.2

package/CHANGELOG.md

@@ -4,6 +4,9 @@ All notable changes to this skill are documented here. Versions follow [Semantic
 
 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.10.2] - 2026-06-12
+- Document the autoNumber-formula blank-read gotcha — a formula that references an Airtable autoNumber field frequently reads back empty through Softr's data layer even though Airtable shows the value and a data re-sync doesn't fix it (sibling formulas without an autoNumber dependency read fine). Add to datasources/airtable.md Gotchas + the Formula row of the field table, with the JS rebuild-from-autoNumber fix and the plain-text-stamped-by-automation alternative; bump to 1.10.2
+
 ## [1.10.1] - 2026-06-12
 - Document useFieldOptions companion-useRecords requirement — the hook only populates once an active useRecords in the same block has loaded the table schema; without it options settles to [] with isLoading false (bites write-only/helper blocks hardest). Add the required companion query to the example, correct the return shape to { options, isLoading } with options { id, label, color }, note the cross-table helper-block pattern, and add a prefer-live-fall-back-to-hardcoded recommendation; bump to 1.10.1
 

package/datasources/airtable.md

@@ -128,7 +128,7 @@ This script reads only **metadata**, never records. To inspect record contents i
 | Phone                | Yes       | |
 | Linked Record        | Read/Write | Returns as `{ label, id }` objects |
 | Rollup               | Read-only | |
-| Formula              | Read-only | |
+| Formula              | Read-only | Reads fine for most formulas — BUT a formula that references an **autoNumber** field often comes back blank through Softr's data layer. See Gotchas → "Formulas depending on autoNumber". |
 | Lookup               | Read-only | |
 | Computed             | Read-only | |
 | Created Time         | Read-only | |
@@ -151,6 +151,21 @@ Mitigation: Use PAT authentication. Cache data where possible. Avoid unnecessary
 - **Linked records are objects** with `{ label, id }` structure, not plain text.
 - **View connections** apply Airtable-side filters and sorts before data reaches Softr. This is useful for pre-filtering but means the Softr block only sees the view's subset.
 - **Column names are case-sensitive.** `"First name"` and `"First Name"` are different.
+- **Formulas that depend on an `autoNumber` field can read back blank** (verified 2026-06-12). Softr serves most formulas fine — a `CONCATENATE` of text fields reads correctly — but a formula like `"WIG-" & RIGHT("0000" & {Autonumber}, 4)` frequently comes through as `""`, even though Airtable shows the value and a data re-sync doesn't fix it. The autoNumber dependency is the differentiator: a sibling formula on the same record (no autoNumber) reads fine.
+  - **Symptom:** one computed field is empty in `record.fields` while the rest populate; re-syncing the Softr data source doesn't help.
+  - **Fix:** don't read the formula — read the raw `autoNumber` field and rebuild the value in JS:
+    ```jsx
+    // q.select({ tag: "Wig Tag ID", auto: "Autonumber", ... })
+    function buildTag(f) {
+      var raw = getFieldValue(f.tag);
+      if (raw) return raw;                       // formula populated — use it
+      var n = f.auto;
+      if (n != null && typeof n === "object") n = (n.value != null) ? n.value : "";
+      var s = (n == null) ? "" : String(n).trim();
+      return s ? "WIG-" + ("0000" + s).slice(-4) : "";  // mirror the Airtable formula in JS
+    }
+    ```
+  - **Alternative (most robust):** add a plain single-line-text field and stamp the value into it with an Airtable automation on record create. Softr reads plain text 100% reliably, with no formula/autoNumber dependency.
 
 ## Best For
 - Teams already managing data in Airtable

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "softr-vibe-coding",
-  "version": "1.10.1",
+  "version": "1.10.2",
   "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"