Homepage Layout.

Your member homepage is the first thing visitors see. Reward Loyalty offers four distinct layouts, each designed for a specific business model. Choose the one that 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: One business with several campaigns, or a curated network of businesses. A premium, wallet-style homepage either way.

The Smart Wallet layout presents your platform as a premium, wallet-style hub. One business can show several campaigns side by side, and a curated network can show many businesses in one place.

What It Shows

• Hero section with animated wallet card visual
• "Your Loyalty, Simplified" value proposition
• Featured programs — all cards, vouchers, stamp cards, and prepaid passes 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, vouchers, and prepaid passes.

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

Enforced as the page renders. The partner permission is re-checked every time the homepage loads, not only when the toggle is set. If a business loses homepage permission—through a plan change or an admin turning it off—its cards, vouchers, stamp cards, and prepaid passes stop appearing right away, even when their individual "Visible on homepage" toggles are still on. Nothing needs to be re-saved or cleaned up.

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 a handful of featured businesses signals a platform worth joining. One business can run several campaigns on the same layout, from a points card to a prepaid pass.

Smart Wallet curates, it does not auto-list. You control who appears. No cold-start problem (start empty, add partners when ready), no brand conflicts (you approve associations), no automatic listings. When your model is a place full of businesses, the Public Listing layout adds search and filters over the same curated set. See Why No Automatic Directory? for the 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, stamp cards, and prepaid passes 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, vouchers, and prepaid passes (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: Installs where another site does the explaining, like a marketing site on your root domain with the loyalty app on a subdomain. It also fits operators running several businesses that should not know about each other, plus QR-code-first flows and kiosk displays.

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 carries no sales pitch, because something else already made the case. A marketing site on your root domain explains the program, then sends people to the loyalty app on a subdomain to sign in. A custom build for a single client does the selling elsewhere. An operator running several unrelated businesses keeps each entry focused on sign-in, with no shared storefront that reveals the others.

Customer scans the QR code at the counter, lands on Portal, signs in, shows their QR to staff, and staff credit the points or stamp.

The visitor arrives to authenticate. 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"

Public Listing

Best for: Shopping districts, malls, business associations, tourism boards—any operator whose product is a place full of businesses, where visitors come to find a business.

The Public Listing layout is a dense, searchable directory of every published program across all four types—loyalty cards, stamp cards, vouchers, and prepaid passes—in one place. Where the Smart Wallet impresses with a curated grid, Public Listing helps a visitor find the program they want among many.

What It Shows

• A unified grid of all visible cards, stamp cards, vouchers, and prepaid passes—paginated and loaded as you scroll
• Search with autocomplete across program and business names, fully keyboard-navigable
• Type filters — All, Loyalty, Stamps, Vouchers, Passes
• Sort — three honest, cross-type orders that interleave every program type rather than grouping by type:
  • Newest (the default) — most recently added programs first, by date across all four types
  • Ending soon — programs whose validity ends soonest first, based on each program's end date (a loyalty card's expiration, a stamp card or voucher's "valid until"). Programs with no end date—prepaid passes are evergreen—sort last
  • Name (A–Z) — alphabetical by program name
• A calm empty state when nothing is published yet, and a no-results state when a search matches nothing

The default order is a true "newest" sort, not a manual "featured" placement. Ordering is driven entirely by real signals—recency, end date, or name—so there is no hidden editorial ranking to maintain. (Operator-controlled promotion is a possible future addition; it does not exist in 5.x.)

Eligibility (Same as Smart Wallet)

Public Listing shows exactly what the three-tier visibility stack already publishes—the partner's homepage permission (an admin override when set, otherwise the plan default) plus their per-item "Visible on homepage" toggle, and only while their business and network are active. It adds no new way to make a partner visible, so partner isolation is preserved: a program that wouldn't appear on the Smart Wallet won't appear here.

Newly Registered Partners

When Public Listing is the active layout, partners who self-register get homepage publishing (cards_on_homepage) enabled automatically, so they can immediately choose which of their programs to feature. The directory fills itself as new businesses join.

• Existing partners are never changed when you switch to (or away from) this layout—their settings stay exactly as they were.
• Admins can override cards_on_homepage per partner at any time under Partner Permissions: turn it on for a partner who registered earlier, or off for one who shouldn't publish.
• Operators on other layouts are unaffected—registration only seeds this when Public Listing is active.

Why Choose This

A traditional public directory lists everyone automatically. Public Listing does not. You control who appears through the same permission stack. For an operator whose whole value is "every business on the high street, in one place", it turns the installation into a branded discovery surface, searchable and filterable, without giving up isolation.

Visual Identity

• Compact program tiles in a dense, responsive grid
• A sticky control bar with search, type filters, and sort
• The partners' own card colors do the talking; the chrome stays quiet

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 four layouts are responsive and built for mobile:

• Smart Wallet, stacked program cards, swipeable carousel
• Showcase, full-width hero, condensed sections
• Portal, centered card, large touch-friendly buttons
• Public Listing, dense grid that reflows to one column, with sticky search and filters

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