What does the Supabase step do?

Most steps are stateless — every tap behaves the same. The Supabase step changes that by storing data per tag in a database you control:

  • Write — save the form responses collected on this tap into the tag’s record (deep-merged with whatever was already stored).
  • Read — load the tag’s stored values back into the flow, where later steps can show them as template variables like {{sku}} or {{qty}}.

This makes patterns like “scan once to register, tap again to see your details” possible. The step runs silently — the Tapper never sees a Supabase screen.

The connection (the “login”)

The step talks to your Supabase project, not a Kitetags database. You authenticate it once by creating a Supabase Connection — a saved project URL plus service-role key — under Apps → Supabase. Until at least one connection exists, the step shows a prompt to add one.

The Supabase step configuration panel in the Kitetags Interaction Builder, showing the Supabase Connection prompt, Read tag data / Write tag data operation options, and an explanatory note about the tag_info table

In v1, data is stored in a single tag_info table per connection, keyed by the tag’s UID. You do not pick tables or columns — all values land in a tag_data JSON column. The connections page provides the SQL to create that table.

How do you set it up?

  1. In Supabase, create a project and run the table SQL from Apps → Supabase (creates the tag_info table).
  2. In Kitetags, go to Apps → Supabase and add a connection (project URL + service-role key).
  3. Open the Interaction Builder and click Add Step → Supabase.
  4. Pick the connection, then choose an operation:
    • Write tag data — place this step right after a Form Input step so there is data to save.
    • Read tag data — place this step before a Display Information Table step so the Tapper can see what was loaded.
  5. Publish the interaction and assign it to a Kitetag Group.

When should you use it?

  • Register-once tags — first tap collects details with a Form Input + Write; later taps Read and display them.
  • Visit counters / last-seen — accumulate simple state per tag.
  • Asset records — store the latest inspection note on the tag itself.

Next steps

Last updated 16 May 2026, 22:33 -0700 . history