Help & Walkthrough

Everything ScalePlus does, with step-by-step instructions.
Email support Back to dashboard

Welcome to ScalePlus

This is the full walkthrough, every screen, every button, every shortcut. If you only have five minutes, start with the Quick start. If you're stuck on one feature, jump there from the table of contents on the left.

Quick start, 5 minutes

Three steps from blank to live

Get a working loyalty program before your next coffee break.
  1. Set up your business. Open Settings → Business and fill in your name, logo, brand color, currency, and contact details. Everything customer-facing pulls from here, sign-up page, card, receipts, notifications.
  2. Build your program. Head to Rewards, pick an earning rule (points, punch card, cashback, tiered, or combine), add 2–4 rewards, choose a card design. The live preview on the right updates as you go.
  3. Share your link. Open Sign-up link, hit Copy to put the URL on your clipboard, or print the QR poster for your counter. New members appear in Members the moment they sign up.
That's the floor. Once your first 5 members sign up, come back to Cashier toolkit for in-store scanning, Notifications to send a "we've launched" push, and Multi-branch if you have more than one location.

Dashboard

Dashboard

The 5-KPI overview, charts, and Install button.
Open

The dashboard is your daily check-in. Five KPI tiles up top (members, repeats, points issued, points redeemed, redemption rate), an Overview line chart, Top Rewards bars, an Engagement donut, a Visits Overview, and a "Points Expiring Soon" list.

What each control does

Branch chip
Click the "All branches" pill to filter the dashboard to one branch. The 4 KPI numbers rescale to that branch's share. Selection lives in this tab only.
Date pill
Picks the date range. (Display-only in the prototype, wires to a real range picker once the backend ships.)
Bell
Quick view of recent system notifications. Red dot = unread.
Owner pill
Your profile + role. Click to switch users (when the backend lands).
Install ScalePlus
Appears when your browser supports PWA install. One tap pins ScalePlus to your home screen as a real app icon.
KPI sparklines
Each tile's bottom line is a 30-day trend. Up = good for all 5 KPIs.
The branch filter only rescales the four big numbers. Charts and lists below still show all-branch data, that's deliberate while the prototype runs on mock data. Once the API is live, every widget filters by branch.

Members

Members directory

Search, filter, inspect, adjust points, audit, import, export.
Open

Every customer who joins your program shows up here. Each row has a per-member QR (printable), home branch, tier dot, points balance, visit count, and last-visit date. Click any row to open the member dialog.

Adjusting points (with audit trail)

  1. Click any member row to open the dialog.
  2. Scroll to Adjust points. Choose + Add or − Remove.
  3. Enter the points amount, pick a reason (Goodwill, Missed scan, Campaign bonus, Referral, Correction, Other), add an optional note (max 80 chars).
  4. Click Apply adjustment. The change appends a row to the member's Audit log with the timestamp, the reason, your name, and the branch you're scoped to. Append-only, you can never edit or delete past entries, only add new ones.

CSV import

  1. Click Import CSV at the top right.
  2. Pick a CSV file with columns name, email, phone, points, joined. Order doesn't matter; column names do.
  3. The preview dialog shows totals: Rows / Ready / Duplicates / Errors. Duplicates are matched by email and phone, existing members are skipped automatically. Per-row errors are listed (e.g. invalid email, missing name).
  4. Click Import to commit. New members are tagged to your active branch and get auto-generated member numbers.

CSV export

Click Export to download a UTF-8 CSV with all members and their branches. Useful for backups, migrations, or wiring an offline campaign.

The CSV includes phone numbers and emails. Treat the file as sensitive, don't email it, don't drop it in shared chat. Security rules apply.

Rewards & program

Rewards builder

Earning rule, reward catalog, tiers, card design, all on one page.
Open

This is the most important page in the app. The earning rule decides how members accumulate value, the reward catalog decides what they can redeem, the card design is what they see in their wallet. Live preview on the right updates as you change anything.

The 6 earning rules

Points per peso
1 point per ₱X spent. Best for cafés, restaurants, retail. Set the ratio + welcome bonus.
Points per visit
Fixed points per check-in. Best for services with similar ticket sizes. Includes cooldown.
Punch card
Buy 9, get the 10th free. Pick the empty + filled icon, the filled color, and the reward at the end.
Cashback
Earn store credit instead of points. Best for higher-priced services.
Tiered
Bronze → Silver → Gold based on lifetime spend or visits. Define each tier's threshold + perks.
Combine
Mix multiple rules, e.g. tiers + birthday bonus + referral.
Picking an earning rule changes the criteria fields on this page automatically. Switch between them, the live preview shows you exactly what members will see for each one.

Reward catalog

  1. Click Add reward to create a new item.
  2. Set the name (what members see), the cost in points, and the icon, pick from 69 Lucide icons grouped into Beauty, Food, Retail, Fitness, Pets, and General.
  3. Cheap rewards first (low-cost wins keep members engaged). Most successful programs have 3–5 rewards spanning 100 → 1500 points.

Card design

Pick a preset (Gradient, Noir, Minimal, Sunrise, Forest), tweak the primary + secondary colors, upload a custom background, choose a texture (dots / grid / noise), and adjust corner radius + image overlay. Everything reflects in the live preview to the right.

Coupons

Discount codes you can target by audience, with optional one-time use.
Open

Coupons live in Rewards → Coupons. They're separate from rewards: a reward is earned by spending points, a coupon is a code that grants a discount at checkout. Members see assigned coupons inside their wallet card.

  1. Click Add coupon. Name it (e.g. "First-time visit"), pick a code (e.g. WELCOME15), choose percent or amount off, and set the discount value.
  2. Optional: set an expiry date, mark it one-time (single redemption per member), and pick the audience, All, New members, Gold tier, Birthday month, or Inactive 30+ days.
  3. Use the per-row controls to pause (temporarily inactive), edit, or delete a coupon.
The customer card has a dedicated coupon variant (one card per code, with a scannable redeem QR). Once you create a coupon, it appears on the customer's card automatically.

Referrals

Reward both sides when an existing member brings a friend.
Open

Each member has a personal referral link: lty.plus/<your-slug>?ref=<member-no>. When the referee signs up through that link (and meets the qualifying spend, if set), both sides get points.

  1. Toggle Enable referral pair on.
  2. Set Points to the referrer (the existing member) and Bonus to the new member. 200 / 100 is a typical starting point.
  3. Set Min qualifying spend. Use 0 for "credit on signup", or e.g. ₱500 if you want to filter out drive-by signups who never visit.
  4. Set the per-month cap to prevent abuse (5 is typical).

Notifications

Send a push notification

Audience picker, composer, phone preview, history.
Open

Reach the right customers at the right moment. Pick an audience (all / by tag / by group / individual), write a short message (60-char title, 180-char body), preview how it'll look on a phone, and send.

  1. Pick an audience. All hits everyone subscribed. By tag filters by computed attributes (e.g. vip, recent, at-risk). By group uses a saved cohort. Individual targets one specific member.
  2. Write the title (max 60) and body (max 180). The phone preview on the right updates live.
  3. Optional: paste a URL that opens when the user taps the notification.
  4. Click Enable browser push the first time you visit, your browser will ask permission. Grant it, then click Send notification.
Today's prototype fires a real OS notification on your device only (via the browser Notification API). Sending to other members' devices needs the push backend (the Cloudflare Worker scaffolded in server/cf-push-worker/). See the Install + Offline sections for context.

Cashier toolkit

Cashier toolkit (counter tablet)

PIN-locked, offline-tolerant, branch-scoped scanning.
Open

A separate, dark-themed PWA designed to live full-screen on the counter tablet. Cashiers scan member QRs, award points or redeem rewards, and end their shift. Owner-only screens are locked away.

Set up a tablet

  1. On the tablet's browser, open /scanner.html. Tap Install on this tablet when the prompt appears. The Cashier Toolkit becomes its own home-screen app, separate from the owner dashboard.
  2. Pick the branch this tablet is at from the topbar dropdown. The choice is saved per-device, switching the workspace's active branch elsewhere won't affect this tablet.
  3. In Settings → Branches → Cashier station PIN, set a 4–6 digit PIN. Cashiers enter it on app open. Sessions auto-expire after 30 idle minutes.

Daily workflow

  1. Open the Cashier Toolkit app. Enter the PIN (or skip if no PIN is set). A new shift starts automatically.
  2. Tap Start camera to enable the QR scanner. The reticle appears. Or tap Simulate scan to demo without a real card.
  3. When a member is matched, their profile + balance + tier appear on the right. Pick the Earn tab to award points, or Redeem to cash in a reward.
  4. For Earn: enter the purchase amount in pesos, hit Award points. Quick-amount chips (₱100 / ₱200 / ₱500 / ₱1000) speed this up.
  5. For Redeem: tap any reward chip the member can afford. Confirms with a toast.
  6. At the end of the shift, tap End shift. The handover dialog shows scan count, points awarded/redeemed, duration, and unique members served. Closing the shift relocks the PIN.
Internet drops? No problem. Each scan is queued in the tablet's IndexedDB and auto-syncs the moment connectivity returns. The status pill in the topbar shows "Offline · 3 queued" so you know exactly what's pending.

Settings

Settings, five tabs

Business · Branches · Team · Roles · Billing.
Open

Business

Logo (upload a square PNG/JPG, ≤512×512 ideal, or pick an emoji), business name, tagline, website, contact email, phone, address, currency, timezone, and brand color. Every customer-facing screen pulls from here.

Branches

See the Multi-branch section below: slot meter, add-on pricing, branch CRUD, and the cashier-station PIN.

Team

  1. Click Invite teammate. Enter their name, email, and role.
  2. They receive an invite link to set up their access. Status flips from InvitedActive on first login.
  3. Use the per-row dropdown to change roles, or the trash icon to remove. The Owner can't be removed.

Roles

Four built-in roles, each with a clear permissions list. Owner = everything. Manager = run the program but no billing or team management. Cashier = scan and award/redeem only. Viewer = read-only dashboard. Custom roles arrive in Pro.

Billing

See your current plan, usage limits, and recent invoices (auto-charged on the 1st of each month). Upgrade or manage from this tab.

Customer card

The wallet members see

Five card variants, swipable, flippable, branded.
Open

When a member taps your sign-up link or scans the QR, this is what they see. The customer card PWA installs to their home screen with your business name and your logo, not ScalePlus's.

The five front-face variants

Points
Default. Balance + tier pill. Best for points-per-peso and points-per-visit.
Punch
10-stamp grid. Fills as the member earns. Hides member number. Best for cafés.
Cashback
Store-credit balance, ₱-prefixed. Best for higher-priced services.
Tier
Prominent tier badge + progress bar to next tier. Best for tiered programs.
Coupon
Single-coupon layout (reward + code + expiry). Has its own redeem QR.

Back face

Tap any card to flip. Back face shows your business name, address (with map link), phone, hours, and a featured menu item. All pulled from Settings → Business + the rewards builder's "Card back" panel.

Multiple programs? The card is a horizontal swipable wallet, one card per program. Pagination dots below show which one's active. Click any card to flip it independently.

How it works

Multi-branch architecture

One workspace. Many physical locations. Per-branch scanner, link, attribution.
Open

A workspace owns one business but many branches. The first branch is included free; each additional branch is an add-on slot (₱599/branch/month in the prototype).

  1. Open Settings → Branches. The slot meter shows used/allowed.
  2. Click Add branch. Set name, slug, address, phone, manager, hours.
  3. If you're at capacity, click Get more slots first.
  4. Switch the active branch via the sidebar workspace switcher (click the workspace pill at the top of the sidebar). Every page that respects the active branch (sign-up link, scanner default, etc.) updates.

Three branch contexts (don't confuse them)

Workspace active

Stored in localStorage. Set via the sidebar switcher. Default scope for new pages.

Dashboard filter

Stored in sessionStorage. Per-tab. "All branches" by default. Doesn't override the workspace selection.

Cashier station

Stored in localStorage per device. The tablet at Greenbelt 5 stays at Greenbelt 5 even when the owner switches branches elsewhere.

Install as a phone app (PWA)

Three separate install identities on one origin.

ScalePlus runs as three Progressive Web Apps. Install the one(s) you need:

Owner Dashboard

For you. Full app with sidebar, all owner pages.

  • Open dashboard.html
  • Tap Install ScalePlus when the button appears in the topbar

Cashier Toolkit

For the counter tablet. Dark theme, full-screen, scoped to scanner.

  • On the tablet, open scanner.html
  • Tap Install on this tablet

Customer Card

For your members. Branded with your logo and name, not ScalePlus's.

  • Member opens their card link from your sign-up page
  • Browser prompts "Add to home screen"

Install on Android (Chrome)

  1. Tap the three-dot menu in the top right of Chrome.
  2. Tap Install app or Add to home screen.
  3. Confirm. The icon appears on your home screen alongside native apps.

Install on iOS (Safari)

  1. Tap the share icon at the bottom (square with arrow up).
  2. Scroll down and tap Add to Home Screen.
  3. Confirm. iOS doesn't have an "install banner" the way Android does, Add to Home Screen is the same thing.

Install on desktop (Chrome / Edge)

  1. Look for the install icon in the address bar (a monitor with a down-arrow).
  2. Click it, confirm.
  3. ScalePlus opens in its own window with no browser chrome. Pin it to your taskbar / dock.
Updates ship via service worker. When a new version is available, you'll see a "New version available · Refresh" pill at the bottom of the screen. One tap, you're on the latest.

Offline & sync behavior

What works without internet, and what queues for later.

ScalePlus keeps working when WiFi flakes. Every page caches its shell, and the cashier scanner queues scans for sync.

Works offline

  • Browsing all pages (cached shell)
  • Viewing customers & their data
  • Cashier scanning + earn/redeem (queued)
  • The customer card itself
  • Local notifications (already-permitted)

Needs internet

  • Sending push notifications to others
  • Real-time sync between devices
  • Wallet pass updates (Track 03)
  • Anything talking to /api or /v1

Auto-sync

Queued scans drain automatically the moment connectivity returns. You'll see a snackbar: "3 queued scans synced".

If a page fails to load while offline, you land on the friendly offline.html page that auto-reloads when you're back online. No browser dinosaur.

Security & PIN

Cashier station PIN, role-based access, what's stored where.

Cashier PIN

A 4–6 digit PIN that locks the Cashier Toolkit. Stored only as a SHA-256 hash via the browser's SubtleCrypto, never as plaintext, never in shared storage. Set it in Settings → Branches. Sessions auto-expire after 30 minutes of idle. End-of-shift forces a re-lock.

Roles & permissions

  • Owner, full access including billing and team.
  • Manager, run the program, but no billing or team changes.
  • Cashier, scan + award/redeem only. No dashboard, no settings.
  • Viewer, read-only dashboard.

UI permissions are a hint today. Once the backend ships (Track 01), every API call re-checks the role server-side.

What's stored where

localStorage
Workspace state (members, programs, branches). Key: loyaltyplus.v4. Encrypted in transit on HTTPS.
sessionStorage
Per-tab UI selections (e.g. dashboard branch filter).
IndexedDB
Cashier offline scan queue (drained on reconnect).
Service worker cache
Shell HTML/CSS/JS, branded images, offline page.
The prototype runs on browser-local storage only. No real auth, no real backend. Don't put live customer data into this preview, see Security rules. Track 01 stands up Postgres + auth + row-level security.

FAQ

How long does setup take?

Five minutes for a working program (logo + earning rule + 2 rewards + sign-up link). Half an hour for a polished one (custom card design, branches, team invites, first notification).

Do my members need to install an app?

No. The customer card opens in any browser, Chrome, Safari, Edge, Firefox. They can install it to their home screen if they want a one-tap shortcut, but it's optional. Their loyalty data lives on your account, not theirs.

Does ScalePlus work on iPhone?

Yes, with one caveat: iOS Safari requires the customer card to be added to the Home Screen before push notifications work (iOS 16.4+). On Android, push works whether the card is installed or not. Your owner dashboard works fine on both, install it like any PWA from Safari's share menu.

What if my internet drops mid-shift?

The Cashier Toolkit keeps scanning. Each earn/redeem is saved to the tablet's IndexedDB queue. The status pill in the topbar shows "Offline · N queued". The moment connectivity returns, the queue drains automatically and you'll see a "3 queued scans synced" snackbar. No data is lost.

How do I add a second location?

Open Settings → BranchesAdd branch. The first branch is free; each additional branch is an add-on slot. Each branch gets its own sign-up link, QR poster, and cashier scanner station.

Can I migrate from another loyalty platform?

Yes. Export your members from your current platform as a CSV with columns name, email, phone, points, joined. On Members, click Import CSV. The preview shows duplicates, errors, and ready-to-import rows before you commit.

What happens to points when I change my earning rule?

Existing balances stay intact. New earns use the new rule. If you switch from "points per peso" to "punch card", balances become punches automatically (we round to the nearest whole punch). Tiered → points conversion uses the lifetime-spend you set.

How do I reset a customer's PIN if they forgot it?

Customers don't have PINs, only cashier stations do. If a cashier forgot the station PIN, open Settings → Branches → Cashier station PIN and click Change PIN. Distribute the new PIN to your team.

Can I send notifications to a single customer?

Yes. On Notifications, switch the audience to Individual, then search by name, email, or member number. Pick the customer, write your message, send.

What's the difference between rewards and coupons?

Rewards are earned by spending points (e.g. "Free Express Facial, 250 pts"). They live in the rewards catalog and appear on every member's card.

Coupons are codes that grant discounts at checkout (e.g. WELCOME15 for 15% off). They can be one-time, expire, and target specific audiences. They appear as a separate coupon card in the wallet.

Are points adjustments reversible?

No. The audit log is append-only, every adjustment is a new entry, never a delete or edit. To "reverse" a 50-point credit, add a −50 adjustment with reason "Correction". Both entries stay in the log forever. This is by design, owners and auditors should always be able to see the full history.

How do I export my data?

Today: CSV export of members from Members → Export. Once the backend ships, you'll get full GDPR-compliant exports (members + transactions + audit) as a single ZIP, scheduled deletion, and per-customer "right to be forgotten" requests.

Can I use my own domain for the sign-up link?

Custom domains are coming with the backend. Today, your link is lty.plus/your-slug, short, memorable, prints well on a poster. You can already redirect from your own domain (e.g. yourshop.com/rewards) at your DNS provider.

How much does ScalePlus cost?

See the pricing on the main site. Starter is free for up to 200 members. Growth is ₱1,490/mo for up to 5,000. Scale is ₱4,900/mo for unlimited. Each extra branch is an add-on slot at ₱599/mo. Custom build is by quote.

Can my members have a single card across multiple ScalePlus businesses?

Not yet, each business has its own card. Cross-merchant member graph (one ScalePlus card, every business) is on the long-game roadmap as Track 12, The Moat. It's our most defensible feature, but it requires the backend to ship first.

Does ScalePlus integrate with my POS?

Loyverse is the first POS integration on the roadmap (Track 09, Distribution). Shopify and a generic webhook follow. Today, cashiers manually enter the purchase amount into the Cashier Toolkit and tap Award points, fast enough for most queues.

What about Apple Wallet / Google Wallet passes?

Google Wallet is in Track 03 of the roadmap, it'll show your member's balance on the lock screen and refresh silently on every transaction. Apple Wallet is deferred (Android-first market). Both require the backend to land first.

Is my data private?

Today's prototype keeps everything in your browser's local storage. Don't put real customer data here yet. The production app (Track 01 + Track 11) ships with: HTTPS-only cookies, server-side row-level security scoped to business_id, GDPR/PDPA/LGPD compliance, SOC 2 Type II, and a public status page.

Still stuck?

We read every message.

One real human, one business day. No script, no chatbot.

Found something missing from this page? Tell us, we update it as the product grows.
Last updated: April 2026.