This is the main Tap Works guide for reps and admin. Use it for sales, taking payment, setting up NFC cards, creating $30/month review pages, updating GitHub, testing pages, and troubleshooting.
The physical card can either go straight to the business's direct Google review page, or the business can take the $30/month Tap Works review-page upsell and have the NFC card point to their unique Tap Works page first.
Show the business how the NFC card works. Tap it with a phone and explain that customers can quickly reach the business's review destination.
Use your assigned Square setup and Tap to Pay. Never use the owner login or another rep's identity.
If the customer does not buy the review-page upsell, get their direct Google review URL and program that URL directly onto the NFC card.
Explain that the $30/month option gives the business a hosted Tap Works review page and a permanent Tap Works NFC URL that can be maintained without replacing the physical card.
Make sure the business has actually subscribed to the $30/month service before creating the live page.
Open:
Enter the four details and press Generate Setup, then press Copy Setup Details.
Example config:
"joes-barber": {
name: "Joe's Barber",
googleReviewUrl: "https://...",
feedbackEmail: "owner@email.com"
}
On phone or computer:
Scroll to the final business in the file. It may look like this:
"last-business": {
name: "Last Business",
googleReviewUrl: "...",
feedbackEmail: "..."
}
};
To add the new business, add a comma after the previous business and paste the new config before the final };:
"last-business": {
name: "Last Business",
googleReviewUrl: "...",
feedbackEmail: "..."
},
"joes-barber": {
name: "Joe's Barber",
googleReviewUrl: "https://...",
feedbackEmail: "owner@email.com"
}
};
},};}; must stay at the very bottom of the business list.
Press:
GitHub Actions will automatically deploy the updated site to Cloudflare.
Open:
You want a green check mark. If the action is red or failed, do not program the NFC card yet.
The Rep Tool gives you the NFC URL. Example:
https://tapworks.pages.dev/r/joes-barberOnly after testing, write the Tap Works URL onto the NFC card:
https://tapworks.pages.dev/r/joes-barberTap the physical NFC card one final time and confirm the full flow works.
This is the fastest method when you are out:
tapworks-site.businesses.js.};.},.main.From now on, make normal site changes through GitHub, not by manually uploading ZIP files to Cloudflare.
/r/business-name routing.If Tap Works gets a new design, update index.html in GitHub and commit it. GitHub Actions deploys it, and all existing business review pages receive the updated design automatically.
The NFC cards do not need to be reprogrammed because their URLs stay the same.
Edit only that customer's entry in businesses.js, commit the change, wait for the green GitHub Action, then test the same existing NFC URL.
Yes. Cloudflare still hosts tapworks.pages.dev. You mainly use Cloudflare for hosting settings, domains and troubleshooting. Normal site/content updates should now happen in GitHub.
}; at bottommainCheck that the slug in the URL exactly matches the key in businesses.js.
Check businesses.js for a missing comma, extra brace, missing closing brace or misplaced final };.
Do not keep changing Cloudflare manually. Open the failed Action and fix the GitHub deployment/code issue first.
Edit that customer's googleReviewUrl inside businesses.js, commit, wait for green deployment, and test again.
Confirm what URL is actually written to the NFC. Review-page customers should have their permanent Tap Works /r/business-name URL programmed onto the card.
Tap Works internal training guide. Update this page through team-training-guide.html in GitHub.