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 app.

Choosing a layout

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

The .env baseline is HOMEPAGE_LAYOUT, with the values directory (Smart Wallet, the default), showcase, portal, and public_listing. A layout saved in the dashboard overrides the .env value.

---

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 installation as the wallet it is named for. A single card leads the page and transforms as the visitor scrolls, becoming each kind of program you run before it settles into the visitor's own card. Below it, your published programs appear as the real wallet cards members collect.

What it shows

• A transforming hero card that becomes a stamp card, a points card, a prepaid pass, and a voucher as the visitor scrolls, then settles into a member's own card
• A live balance on the settled card: A signed-in member sees their name and their points across every business on the installation; a visitor who is not signed in sees a clearly marked sample
• Your programs as wallet cards, grouped into loyalty, stamps, vouchers, and prepaid passes, showing every card, voucher, stamp card, and pass marked as visible
• A short "how it works" primer and a few common questions, shown on every visit
• A "For businesses" invitation that links to business sign-in and sign-up whenever partner registration is open

Homepage visibility control

Homepage publishing is controlled in three tiers:

1. Plan defines the default: Each plan has a has_cards_on_homepage flag, set per tier with PLAN_<TIER>_HAS_CARDS_ON_HOMEPAGE in .env. This is disabled by default across all plans, meaning no partner can publish to the homepage unless explicitly allowed. Plan flags are also editable in the admin Plans editor, whose saved values override .env.
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 app re-checks the partner permission 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 directory 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.

The card stays live

The settled card reflects real activity. When staff credit points or add a stamp anywhere on the installation, the card on an open homepage rolls its balance or presses a new stamp within a few seconds, with no refresh. The page keeps polling in the background, so it feels alive without drawing attention to itself.

Visual identity

• One credit-card-shaped hero in a deep, premium finish
• The card reacts to real activity, so the page feels alive
• Programs shown as the same cards members keep in their wallet
• Calm and app-like, built around the card

---

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:

The three toggles have .env baselines: HOMEPAGE_SHOW_HOW_IT_WORKS (default true), HOMEPAGE_SHOW_TIERS (default true), and HOMEPAGE_SHOW_MEMBER_COUNT (default false). Values saved in the dashboard override them.

Note: The hero headline and subheadline are not dashboard settings. They are translation strings (showcase_headline and showcase_subheadline in lang/<locale>/common.php), so you customize them per language via the language files. See Languages & translations.

Why choose this

Showcase works well for:

• Single-business installations: Where only one partner exists, so all visible programs are theirs
• Curated multi-partner sites: 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 sign 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 on the login page
• 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. Real signals drive the ordering (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 it preserves partner isolation: 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, so they can choose which of their programs to feature right away. 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 on signup. 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

Use this table to choose a layout for 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, the hero card's story plays as clear frames, and programs stack into one column
• 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 app, you can modify these templates. Always backup before making changes.

Caching

The homepage renders fresh on each request to reflect the latest programs and settings. Changing the layout needs no cache clearing.

---

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