Documentation
Complete guide to Smoke Tokens
Everything you need to set up and manage your customer loyalty program for smoke shops, vape stores, and dispensaries.
Overview
Set up your loyalty program in under 10 minutes
- • Dashboard configuration
- • Customer rewards setup
- • Kiosk customization
- • Tablet deployment
Customer-facing tablet interface with secure access
- • Phone number entry
- • Points & rewards display
- • Instant redemption
- • Store owner access
Real-time insights and customer data
- • Customer engagement
- • Points tracking
- • Tier progression
- • Business insights
Customer Management
Track customer data, points, and engagement
Rewards System
Create and manage reward tiers and redemptions
Secure Kiosk
Network-protected tablet interface
Brand Customization
Match your store's look and feel
Quick Setup
1. Dashboard Configuration
Access Dashboard
Navigate to /dashboard and sign in
Configure Rewards
Set up reward tiers and redemption options
Add Customers
Import existing customers or start fresh
2. Kiosk Setup
Customize Branding
Upload logo, set colors, and store info
Configure Settings
Set PIN, timeouts, and display options
Deploy to Tablet
Register and authorize tablet devices
Quick Start Tip
Start with the Purple Dream color theme and default settings. You can always customize later as you learn what works best for your store.
Kiosk System
Phone Number Entry
Customers enter their 10-digit phone number with automatic formatting. The system validates the number and redirects to their points page.
Points & Rewards Display
Shows current points balance, tier status, available rewards, and upcoming rewards with points needed.
Instant Redemption
Customers can redeem available rewards directly from the kiosk with animated feedback and confirmation.
Auto-Return Timer
Configurable timeout returns to main screen automatically for security and privacy.
PIN Protection
2-digit PIN protects store owner functions. Default is “12” but can be customized in settings.
Customer Lookup
Search customers by phone number to view their complete profile and transaction history.
Points Management
Add, subtract, or redeem points with reason tracking. All transactions are logged for audit trails.
Real-time Updates
Changes sync immediately across all interfaces with toast notifications for confirmation.
Branding
- • Store name and tagline
- • Logo upload and preview
- • Custom footer messaging
- • Welcome screen content
Colors & Themes
- • 6 pre-built color themes
- • Custom color picker
- • Gradient backgrounds
- • Live preview updates
Behavior Settings
- • Auto-return timer (15-120 seconds)
- • Sound effects toggle
- • Animation controls
- • Display options
Tablet Security
Network Security
- IP whitelisting for local networks
- Device fingerprinting for identification
- Rate limiting to prevent abuse
Access Control
- Manual device authorization required
- Session timeout after 30 minutes
- Maximum 5 concurrent sessions
Initial Access Attempt
When a new tablet tries to access /kiosk, it will be prompted to register.
Device Registration
Tablet submits device name, location, and generates unique fingerprint.
Manager Authorization
Store manager reviews and authorizes the tablet in the dashboard.
Kiosk Access Granted
Authorized tablet can now access the full kiosk interface.
Dashboard Access
Navigate to Dashboard → Kiosk → Manage Tablets to view all registered devices.
Authorization Control
Authorize pending tablets or revoke access from existing ones instantly.
Device Monitoring
View device details, IP addresses, last seen times, and activity status.
Security Statistics
Monitor authorized vs pending tablets with real-time statistics.
Best Practice: Only authorize tablets that are physically in your store and on your secure network.
Allowed Networks
By default, the system allows common local network ranges:
These cover most home and business router configurations
Security Features
- • Automatic IP validation
- • Device fingerprint verification
- • Rate limiting (60 requests/minute)
- • Session timeout protection
- • Manual authorization requirement
Deployment Recommendations
- • Use a dedicated WiFi network for kiosk tablets if possible
- • Ensure tablets are always connected to your store's network
- • Regularly review authorized devices in the tablet management dashboard
- • Revoke access for tablets that are no longer in use
Features
Complete customer database with engagement tracking
- • Phone-based customer lookup
- • Points balance tracking
- • Visit history and frequency
- • Tier progression monitoring
- • Spending pattern analysis
Flexible reward tiers and redemption options
- • Tier-based rewards (Bronze, Silver, Gold, Platinum)
- • Point-based redemption system
- • Instant kiosk redemptions
- • Custom reward configuration
- • Automatic tier upgrades
Real-time business insights and data export
- • Daily activity statistics
- • Customer engagement metrics
- • Points and redemption tracking
- • Tier distribution analysis
- • Data export capabilities
Make the kiosk match your store's brand
- • Logo upload and preview
- • 6 pre-built color themes
- • Custom color selection
- • Store name and tagline
- • Welcome message customization
Multi-layer security for tablet deployment
- • Network IP whitelisting
- • Device fingerprinting
- • Manual tablet authorization
- • Session timeout protection
- • Rate limiting and abuse prevention
Complete store operation controls
- • PIN-protected owner access
- • Points add/subtract/redeem
- • Transaction history tracking
- • Customer search and lookup
- • Real-time sync across devices
API & Analytics
Customer Analytics
- • Complete customer profiles
- • Points earned and spent tracking
- • Visit frequency and patterns
- • Tier progression history
- • Engagement scoring
Session Tracking
- • Individual kiosk sessions
- • Action-by-action logging
- • Reward redemption tracking
- • Points management history
- • Session duration analytics
Data Export (Development Mode)
In development mode, analytics data is automatically exported to JSON files in the /data folder:
- •
latest.json- Most recent export - •
analytics_[timestamp].json- Historical exports - • Accessible without customer login requirements
- • Real-time sync on redemptions and major actions
Daily Statistics
View today's customer count, points distributed, redemptions, and top customers.
Customer Database
Searchable customer list with filtering by tier, sorting options, and detailed profiles.
Business Insights
Tier distribution, engagement trends, and activity summaries for strategic planning.
Tier System
Automatic Upgrades
Customers are automatically upgraded to higher tiers as they earn points, unlocking better rewards.