Tap Works

Team Training & Setup Guide

Everything reps and admins need in the field, organised for fast phone use.

Rep Setup Tool GitHub Tap Works Home
Quick StartSalesPhone Setup$30 UpsellGitHubNFC ToolsTestingTroubleshooting
Core rule: payment first → setup → deploy → test → program NFC → test again → handover.
1. Sales & Pricing
Physical NFC cards
1 card — $50
2 cards — $70

Hosted Tap Works review page
$30/month

The normal card can link directly to Google Reviews. The hosted-page upsell gives the business a polished Tap Works page with its business name, private feedback option and Google Review CTA.

DEMO → SELL → SQUARE PAYMENT → OPTIONAL $30/MONTH UPSELL → SETUP → TEST → NFC → HANDOVER
2. Staff Phone Setup

Create a phone folder called Tap Works.

Square POS
Square Dashboard
GitHub
Discord
Recommended folder:

Square POS
Square Team
Square Dashboard browser shortcut
GitHub
Tap Works Rep Tool
Tap Works Training Guide
NFC Tools
Notes
Discord
Tap Works social shortcuts
NFC Tools:
Use the free NFC Tools app for programming cards. It is the free app with the orange NFC-style icon in the Apple App Store. Reps should install it before going into the field.
3. $30/Month Review Page

Confirm the customer is on the Tap Works $30/month subscription in Square before creating the hosted page.

  • Business name
  • Direct Google review link
  • Feedback email
  • Rep name / ID

Open the Rep Tool, enter all details, generate the setup and copy the configuration block.

https://tapworks.pages.dev/rep-tool.html
4. GitHub Business Setup

Trusted reps/admins use their own GitHub accounts as collaborators. Never share the owner login.

GitHub → tapworks-site → businesses.js → Edit → paste new block before final }; → commit directly to main → check Actions.
Code rule:
Every business except the final business ends with },. The file has one final }; at the bottom.

The latest GitHub Action must be green before you program the NFC card.

5. Programming Cards with NFC Tools

For a standard physical card

Write the business's direct Google review URL to the NFC card.

For a $30/month hosted-page customer

Write the permanent Tap Works URL generated by the Rep Tool:

https://tapworks.pages.dev/r/business-name

NFC Tools process

  1. Open NFC Tools.
  2. Choose Write.
  3. Choose Add a record.
  4. Select the URL / URI option.
  5. Paste the correct Google or Tap Works URL.
  6. Confirm the URL is correct before writing.
  7. Press Write.
  8. Hold the NFC card to the top/back of the phone until the app confirms the write.
  9. Close NFC Tools and tap the card normally to test it.
Never hand the card over without testing it after writing.
6. Full Field Test
  • Square payment completed
  • Subscription completed if customer bought hosted page
  • Rep Tool details are correct
  • GitHub Action is green
  • Business page opens correctly
  • Business name is correct
  • Stars work
  • Google Review button opens correct listing
  • Private feedback button works
  • NFC card is written with correct URL
  • NFC card is tested from a phone
7. Troubleshooting

Review page not found

Check the URL slug matches the business key in businesses.js.

GitHub Action is red

Fix the GitHub issue first. Do not manually change Cloudflare as a workaround.

NFC card does nothing

Write the URL again in NFC Tools, confirm the app shows a successful write, then test with another NFC-capable phone.

NFC opens the wrong page

Rewrite the card with the correct URL and test before handover.

Wrong Google listing

Update the business's Google review URL in businesses.js, commit, wait for green deployment, then test again.

8. Tap Works Social Links

Use the individual Tap Works accounts when sharing the brand online:

Instagram TikTok Discord

Public Linktree exists for social bios, but the website should use the individual links above.

Tap Works internal training guide