softr-vibe-coding 1.3.1 → 1.3.3

package/CHANGELOG.md

@@ -4,8 +4,16 @@ 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.3.3] - 2026-05-21
+- Document field-type write shapes (Date, Date Range, Multi-Select, Checkbox, Attachment, Number); add async uploadAsync example; show useChartData bucket sample outputs; bump to 1.3.3
+
+## [1.3.2] - 2026-05-21
+- Fix CHANGELOG anchor detection in publish workflow; bump to 1.3.2
+
 ## [1.3.1] - 2026-05-21
-- (no notable changes)
+- Add CHANGELOG.md with auto-generation on publish (workflow now prepends a new entry from commit subjects between version bumps and commits the updated CHANGELOG.md back to main with `[skip ci]`)
+- Backfill CHANGELOG.md entries for 1.0.0 → 1.3.0 from existing git history
+- Add CHANGELOG.md to the npm tarball via package.json `files`
 
 ## [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`)

package/datasources/reading.md

@@ -212,7 +212,17 @@ var result = useChartData({
 });
 ```
 
-Grouping buckets: `metric.bucket.year`, `metric.bucket.month.iso`, `metric.bucket.month.long`, `metric.bucket.day.iso`, `metric.bucket.day.long`
+**Grouping buckets** — pick by what you want the x-axis to show:
+
+| Bucket constant | Sample output | Use for |
+|---|---|---|
+| `metric.bucket.year` | `"2025"` | Yearly trends |
+| `metric.bucket.month.iso` | `"2025-03"` | Monthly trends, sortable x-axis |
+| `metric.bucket.month.long` | `"March 2025"` | Monthly trends, human-readable labels |
+| `metric.bucket.day.iso` | `"2025-03-15"` | Daily trends, sortable x-axis |
+| `metric.bucket.day.long` | `"Mar 15, 2025"` | Daily trends, human-readable labels |
+
+Pair `.iso` variants with `orderBy: q.asc(...)` for correct chronological sorting; use `.long` variants when the bucket value is rendered directly as a label.
 
 Use **recharts** with shadcn's chart wrapper:
 

package/datasources/writing.md

@@ -180,6 +180,22 @@ upload.uploadAsync(file).then(function(results) {
 });
 ```
 
+### Async/await style
+
+The official Softr Vibe Coding docs use this form; it's more ergonomic when uploading inside a larger async flow:
+
+```jsx
+var [result] = await upload.uploadAsync(file);
+if (result.status === "completed") {
+  createRecord.mutate(
+    { fields: { attachment: { filename: result.file.name, url: result.url } } },
+    { onSuccess: function() { toast.success("Saved"); } }
+  );
+}
+```
+
+**Stick with `.mutate(...)` even inside async functions** — don't switch to `.mutateAsync(...)` just for the await ergonomics. Softr's Action parser only recognizes the `.mutate(` token, so any mutation written as `.mutateAsync(` produces no derived Action and `enabled` stays `false` (see "Two parser requirements for `useRecordUpdate`" below).
+
 ## Linked Record Format for Mutations
 
 ```jsx
@@ -231,6 +247,92 @@ Verified by direct experiment (April 2026) for `useRecordCreate`. The same patte
 
 Array of `{ id }` objects. See "Linked Record Format for Mutations" above.
 
+### Multi-Select
+
+Array of option UUIDs as plain strings — mirrors Single Select but wrapped in an array:
+
+```jsx
+// CORRECT
+createRecord.mutate({ tags: ["uuid-1", "uuid-2"] });
+
+// WRONG -- {id, label} objects (returned on read, rejected on write)
+tags: [{ id: "uuid-1", label: "Urgent" }]
+
+// WRONG -- display labels
+tags: ["Urgent", "Internal"]
+```
+
+_Inferred from the read shape (see [fields.md](fields.md)); verify by experiment before production use._
+
+### Number
+
+Plain JS number, not string:
+
+```jsx
+createRecord.mutate({ price: 49.99, quantity: 3 });
+```
+
+To clear, `null` works on Softr Database (`""` is invalid for numeric fields). Other data sources not independently verified.
+
+### Checkbox
+
+Boolean `true` / `false`:
+
+```jsx
+createRecord.mutate({ isActive: true });
+```
+
+**Softr Database** also accepts the string forms `"true"` / `"false"` (mirrors the `string or boolean` read shape — see [fields.md](fields.md)). **Google Sheets** requires the string form, not native booleans — see [google-sheets.md](google-sheets.md). Other data sources expected to accept the boolean form but not independently verified.
+
+### Date
+
+ISO string. Date-only fields take `YYYY-MM-DD`; date-time fields take the full ISO form:
+
+```jsx
+// Date-only field
+createRecord.mutate({ dueDate: "2025-03-15" });
+
+// Date-time field — use new Date().toISOString() for current timestamp
+createRecord.mutate({ lastSeenAt: "2025-03-15T14:00:00Z" });
+```
+
+_Inferred from the read shape (see [fields.md](fields.md)); verify by experiment before production use._
+
+### Date Range
+
+Object with `from` and `to` ISO strings — mirrors the read shape (`{ from, to }` per [fields.md](fields.md)):
+
+```jsx
+createRecord.mutate({
+  bookingWindow: { from: "2025-03-15", to: "2025-03-20" },
+});
+```
+
+_Inferred from the read shape (see [fields.md](fields.md)); verify by experiment before production use._
+
+### Attachment
+
+`{ filename, url }` for a single attachment, or an array of those objects for multi-attachment fields:
+
+```jsx
+// Single attachment
+createRecord.mutate({
+  document: { filename: "report.pdf", url: "https://..." },
+});
+
+// Multiple attachments
+createRecord.mutate({
+  gallery: [
+    { filename: "photo1.jpg", url: "https://..." },
+    { filename: "photo2.jpg", url: "https://..." },
+  ],
+});
+```
+
+To upload a file before writing it to a record, see [File Uploads](#file-uploads) above for the full `useUpload` flow.
+
+_Shape matches the example shown in [File Uploads](#file-uploads). Not yet independently verified across all data sources._
+
 ### Text / Email / URL / Phone
 
 Plain string. To clear a value, both `null` and `""` work for Softr Database text fields (verified by direct experiment, May 2026, for `useRecordUpdate`). Behavior on other data sources has not been independently verified.

package/package.json

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