Homepage Layout.

Your member homepage is the first thing visitors see. Reward Loyalty offers three distinct layouts, each designed for a specific type of business model. Choose the one that best matches how you'll use the platform.

Choosing a Layout

Navigate to Settings > Homepage tab in the admin dashboard. Select your preferred layout and click Save. Changes take effect immediately.

Smart Wallet

Best for: Agencies, franchises, shopping districts, and any installation serving multiple businesses.

The Smart Wallet layout presents your platform as a unified rewards hub. Visitors see a curated selection of loyalty programs—creating the sense that they're joining a network, not just a single store.

What It Shows

• Hero section with animated wallet card visual
• "Your Loyalty, Simplified" value proposition
• Featured programs — all cards, vouchers, and stamp cards marked as visible
• How It Works steps for new visitors
• Membership tiers (if configured)

Homepage Visibility Control

Homepage publishing is controlled in three tiers:

1. Plan defines the default — Each plan in config/plans.php has a has_cards_on_homepage flag. This is disabled by default across all plans, meaning no partner can publish to the homepage unless explicitly allowed.
2. Admin overrides per partner — Via Partner Permissions, admins can enable or disable homepage publishing for individual partners, regardless of the plan default. Note: when a partner's plan changes, permissions are re-derived from the new plan. Admin overrides must be re-applied after a plan change if they differ from the new plan's defaults.
3. Partner uses the toggle — Partners with the permission see a "Visible on homepage" toggle when creating or editing their cards, stamp cards, and vouchers.

When a partner has permission and enables visibility for an item:

For single-business installations: Enable has_cards_on_homepage in the plan (or override per partner), and the partner controls what appears. Simple.

For multi-partner installations: Leave the plan default off and grant permission selectively per partner. This is useful for monetizing homepage placement or curating quality.

For premium tiers: Enable has_cards_on_homepage in higher-tier plans to make homepage publishing a paid feature — partners must upgrade to get visibility.

Why Choose This

The Smart Wallet communicates network value. When a customer sees multiple programs, they perceive more benefit from creating an account:

"One account gives me rewards at the coffee shop, gym, AND bookstore? That's worth signing up."

Even with just 3-4 featured businesses, visitors see a platform worth joining—not a single store's basic loyalty card.

This is different from a public directory. You control who appears. There's no cold-start problem (start empty and add partners when ready), no brand conflicts (you approve associations), and no automatic listings. See Why No Directory? for the full reasoning.

Visual Identity

• Large wallet card hero with floating icons
• Gradient backgrounds with subtle animations
• Program cards displayed in a browseable grid
• Modern, app-like aesthetic

Showcase

Best for: Single businesses, or installations where you want an editorial presentation of available programs.

The Showcase layout presents programs with an editorial-style hero section. It feels more like a brand landing page than a wallet interface.

Note: Showcase displays the same programs as Smart Wallet (all visible cards, vouchers, and stamp cards from all partners). The difference is presentation style, not content filtering.

What It Shows

• Full-width hero with custom headline and subheadline
• Featured programs grid — all visible cards, stamps, and vouchers (up to 6 per type)
• How It Works steps (optional)
• Membership tiers section (optional)
• Call-to-action buttons for join/login

Showcase Options

When you select Showcase, additional settings appear:

Why Choose This

Showcase works well for:

• Single-business installations — Where only one partner exists, so all visible programs are theirs
• Curated multi-partner platforms — Where you want an editorial feel but still show multiple businesses

"Welcome to Joe's Coffee Rewards. Buy 10 drinks, get one free."

The editorial presentation feels more brand-forward than the wallet grid style.

Visual Identity

• Clean typography, generous whitespace
• Featured program card as visual anchor (optional)
• Warm, inviting tone
• Less app-like, more brand-site-like

Portal

Best for: QR-code first experiences, digital kiosk displays, or platforms where customers arrive already knowing about the program.

The Portal layout strips away all explanation. It's a minimalist sign-in page with your logo, a brief tagline, and buttons to log in or create an account.

What It Shows

• Centered card visual with premium styling
• Welcome message and tagline
• Sign in button
• Create account link for new visitors
• Clean, focused design — nothing else

Why Choose This

Portal is perfect when customers already know why they're there:

Customer scans QR code at counter → lands on Portal → signs in → shows their QR to staff → staff credits points/stamps.

They don't need to be sold on the concept. They just need to authenticate. Any explanation would slow them down.

Visual Identity

• Centered single-column layout
• Subtle ambient gradient background
• Premium card visual for brand polish
• Minimal text, maximum clarity

Best Use Cases

• Table tents with QR codes — customers scan and land directly on login
• Receipt footers — "Scan to access your rewards wallet"
• Digital displays — kiosk or tablet at point of sale
• Email links — "Sign in to check your balance"

Matching Layout to Business Model

Here's a quick reference for choosing the right layout based on your use case:

💡 Tip: Homepage publishing requires the has_cards_on_homepage permission (set by plan or admin override). Partners with this permission control which specific items appear using the per-card "Visible on homepage" toggle.

Mobile Experience

All three layouts are fully responsive and optimized for mobile devices:

• Smart Wallet — Stacked program cards, swipeable carousel
• Showcase — Full-width hero, condensed sections
• Portal — Centered card, large touch-friendly buttons

The PWA (Progressive Web App) experience starts from whichever homepage layout you've selected. When customers "Add to Home Screen," they'll see your layout on every visit.

Customization Options

Beyond layout selection, you can customize:

See Branding for complete logo and color configuration.

Technical Notes

Layout Files

Each layout is rendered from its own Blade template:

If you're customizing the platform, you can modify these templates directly. Always backup before making changes.

Caching

Homepage content is rendered fresh on each request to reflect the latest programs and settings. No cache clearing is required after changing the layout.

Related Topics

• Branding — Logo, colors, and application name
• Who Is This For? — Business models and recommended layouts
• The Shared Wallet Concept — Architecture behind multi-partner support