Getting Started Guide (First 30 Minutes)

This guide gets you from account access to a verified scan event.

1. Access your account and open the webapp

• Sign in with your configured authentication method.
• Open the webapp and confirm navigation access to Staging and Active tag views.

2. Create two Draft tags in Staging

Create one of each type:

• Direct tag:
• Name and description
• Destination `link`
• Hyper tag:
• Name and description
• `webhook` URL
• Optional JSON `payload`

3. Validate configuration fields

Before activation:

• Confirm the Direct link is correct and reachable.
• Confirm Hyper webhook endpoint and payload JSON are valid.
• Ensure expected ownership and permissions are in place.

4. Activate tags and download QR

• Activate each draft tag.
• Download each QR code from the drawer.
• Place codes in a controlled test environment.

5. Run test scans

• Scan the Direct tag and verify redirect behavior.
• Scan the Hyper tag and verify webhook response behavior.

6. Verify events in analytics context

For active tags, open the drawer and inspect recent scan chart activity.

Confirm:

• Events are visible in the last 30-day view.
• Success/failure behavior matches expected outcomes.

Troubleshooting checklist

• `permission-denied` on events read: update Firestore rules for `events` read access.
• Query index error: create the `events(tagId ASC, timestamp ASC)` index.
• Hyper execution failures: verify webhook URL availability and payload schema.
• Missing tag updates: confirm authenticated user owns the tag document when required.