UI Pages Documentation
This reference tours the main screens of PubCrawl by route. The screenshots below are captured from a live install with demo data. Pages are Next.js 16 App Router route segments under src/app/. There are five broad areas, each with its own URL prefix and layout:
| Area | URL prefix | Location |
|---|---|---|
| Storefront (public) | /, /listings, /booking, … |
src/app/(site)/ |
| Customer area | /customer/* |
src/app/customer/(app)/ |
| Host (guide) area | /host/* |
src/app/host/(app)/ |
| Admin panel | /admin/* |
src/app/admin/(panel)/ |
| Influencer area | /influencer/* |
src/app/influencer/(app)/ |
Storefront pages (src/app/(site))
The public marketing + crawl-catalogue experience. No sign-in required for browsing or starting a booking.
| Page | Route | What it does |
|---|---|---|
| Home | / |
Landing page — hero slider, featured crawls, categories, testimonials |
| Crawl catalogue | /listings |
Search grid with theme/pace/price filters and facets |
| Crawl detail | /listings/[slug] |
Single crawl — summary, what's included, host, sessions, reviews, book |
| Booking / checkout | /booking/checkout |
Pick spots + extras, pay deposit or full |
| Booking confirmed | /booking/confirmed |
Post-payment confirmation screen |
| How it works | /how-it-works |
Explains the browse → book → go flow |
| Become a host | /careers, /enquiry |
Host onboarding + lead-capture pages |
| Blogs | /blogs |
Blog index and article pages |
| Gallery | /gallery |
Media gallery |
| About / Contact / FAQ | /about, /contact, /faq |
CMS + lead-capture pages |
| AI tools | /ai-tools |
Public AI assistant / helper surface |
| CMS pages | /[slug] |
Builder / CMS-authored pages resolved by slug |
| Legal | /privacy-policy, /terms-and-conditions, /cookie-policy, /refund-policy |
Policy pages |
Home — /
The storefront landing page (src/app/(site)/page.tsx). Composes the hero slider, featured crawls, categories, testimonials and CTAs. Public.
Crawl catalogue — /listings
The catalogue grid (src/app/(site)/listings/page.tsx) with search, theme/pace and price filters. Backed by GET /api/v1/listings (paginated/sorted/filtered).
Crawl detail — /listings/[slug]
The conversion page for a single crawl (src/app/(site)/listings/[slug]/page.tsx). Renders the title, summary, "What's included", the host, available sessions (departures) with spot counts, and reviews, with a book action. Data comes from GET /api/v1/listings/:slug (and /reviews, /availability).
Booking / checkout — /booking/checkout
Collects guest/contact details, spot count and any paid extras, then takes payment. Spots are claimed atomically against the chosen session, and the customer pays a deposit or the full amount through the configured gateway. On success the flow lands on /booking/confirmed.
Customer area (src/app/customer/(app))
The signed-in area for guests who book crawls. Requires a customer session; the layout renders CustomerChrome + CustomerSidebar.
| Page | Route | What it does |
|---|---|---|
| Dashboard | /customer/dashboard |
"Your bookings at a glance" — summary cards + recent activity |
| Bookings | /customer/bookings, /customer/bookings/[public_id] |
Upcoming/past bookings + booking detail (spots, extras, invoice) |
| Wishlist | /customer/wishlist |
Saved crawls |
| Reviews | /customer/reviews |
Reviews the customer has left / can leave after a crawl |
| Messages | /customer/messages |
Conversations with hosts |
| Payments | /customer/payments |
Payment history + invoices |
| Notifications | /customer/notifications |
Notification inbox |
| Support | /customer/support |
Support tickets |
| Settings | /customer/settings |
Profile, addresses & account settings |
Dashboard — /customer/dashboard
The customer landing screen (src/app/customer/(app)/dashboard/page.tsx). Summarises upcoming sessions, recent bookings and activity.
Bookings — /customer/bookings
Lists the customer's bookings, each linking to a detail page at /customer/bookings/[public_id] showing the crawl, session date/time, spots, extras, payments and an invoice (InvoiceModal). Cancellations follow the tiered refund policy and release spots.
Host (guide) area (src/app/host/(app))
The workspace for hosts who list and run crawls. Requires a host session; the layout renders HostSidebar.
| Page | Route | What it does |
|---|---|---|
| Dashboard | /host/dashboard |
"Your crawls at a glance" — KPIs + upcoming sessions |
| Listings | /host/listings, /host/listings/new, /host/listings/[id] |
Create & manage crawls (details, amenities, sessions, languages) |
| Calendar | /host/calendar |
Session calendar / scheduling |
| Reservations | /host/reservations |
Incoming bookings to confirm / manage |
| Inbox | /host/inbox |
Messages with customers |
| Insights | /host/insights |
Performance analytics |
| Reviews | /host/reviews |
Reviews on the host's crawls |
| Payouts | /host/payouts |
Earnings & payout requests |
| Billing | /host/billing |
Host subscription to list crawls |
| Settings | /host/settings |
Host profile & preferences |
Dashboard — /host/dashboard
The host landing screen (src/app/host/(app)/dashboard/page.tsx), surfacing the host's crawls, upcoming sessions and headline metrics.
Listings — /host/listings
The host's crawl manager (src/app/host/(app)/listings/page.tsx). The editor (ListingForm) is organised into tabs — details, an AmenitiesTab ("What's included"), a SessionsTab (scheduled departures with seats_total), a LocationPicker, and a LanguagesTab. New crawls are created at /host/listings/new; existing ones edited at /host/listings/[id].
Admin panel (src/app/admin/(panel))
The administration console. Requires an admin session; write actions are RBAC-gated per route. Pages typically open with <PageHeader> and use the shared UI primitives.
| Page | Route | What it does |
|---|---|---|
| Dashboard | /admin/dashboard |
KPIs + "Revenue over time" chart |
| Listings | /admin/listings |
Review & manage the crawl catalogue |
| Bookings | /admin/bookings |
Manage all bookings and payment transactions |
| Refunds | /admin/refunds |
Cancellation refund approval queue |
| Hosts / Customers | /admin/hosts, /admin/customers |
Manage hosts and customers |
| Extras / Amenities | /admin/extras, /admin/amenities |
Paid add-ons and "what's included" catalogue |
| Coupons | /admin/coupons |
Discount coupons |
| Reviews | /admin/reviews |
Moderate crawl reviews |
| Issues / Leads | /admin/issues, /admin/leads |
Reported issues and captured leads |
| Calendar | /admin/calendar |
Sessions across all hosts |
| Content (CMS) | /admin/pages, /admin/blogs, /admin/faqs, /admin/gallery, /admin/hero-slider, /admin/testimonials, /admin/partners, /admin/about, /admin/why-choose-us, /admin/menus |
CMS content |
| Builder / Theme | /admin/builder, /admin/theme-builder |
Page builder & theme builder |
| Master data | /admin/master-data |
Crawl themes, crawl formats, pace, locations |
| Media | /admin/media |
Media library |
| Marketing / Apps | /admin/marketing, /admin/apps |
Marketing tools & installed add-ons |
| License | /admin/license |
License activation & entitlements |
| Settings | /admin/settings/* |
Platform settings (see below) |
Dashboard — /admin/dashboard
The admin landing screen (src/app/admin/(panel)/dashboard/page.tsx). Opens with "Welcome back," shows headline KPIs and a "Revenue over time" chart. Data from GET /api/v1/admin/dashboard.
Bookings (admin) — /admin/bookings
Booking management (src/app/admin/(panel)/bookings/page.tsx) — every booking, its seats, extras, payments and status. Cancellations that request money back land in the Refunds queue (/admin/refunds), where an admin approves or rejects each booking_refunds request.
Add-ons & Integrations — /admin/settings/integrations
The add-ons screen (src/app/admin/(panel)/settings/integrations/page.tsx) where premium integrations and feature plugins are unlocked with a purchase code and toggled on. See the Add-on Development Guide and Plugin Development Guide.
Settings — /admin/settings/*
The settings hub. Sections (each a route segment under src/app/admin/(panel)/settings/) include: theme, payments, booking, monetization, plans (host subscription plans), currencies, countries, locations, languages, users, roles, permissions, integrations, webhooks, api-tokens, backup, notifications, notification-log, and activity. Each section reads/writes via GET/POST /api/v1/admin/settings/:section (plus dedicated routes for users, roles, languages, etc.).
Influencer area (src/app/influencer/(app))
The affiliate workspace. Requires an influencer session; the layout renders InfluencerChrome + InfluencerSidebar.
| Page | Route | What it does |
|---|---|---|
| Dashboard | /influencer/dashboard |
Referral performance at a glance |
| Referral links | /influencer/referral-links |
Create & manage tracked referral links |
| Analytics | /influencer/analytics |
Clicks, visits and conversion analytics |
| Bookings | /influencer/bookings |
Bookings attributed to the influencer |
| Commission | /influencer/commission |
Earned commissions |
| Payouts | /influencer/payouts |
Commission payout requests |
| Listings | /influencer/listings |
Browse crawls to promote (ProductBrowser) |
| Marketing materials | /influencer/marketing-materials |
Share assets & tools (ShareTools) |
| AI chat | /influencer/ai-chat |
AI assistant for content (InfluencerAiChat) |
| Notifications | /influencer/notifications |
Notification inbox |
| Profile / Settings | /influencer/profile, /influencer/settings |
Public profile, social links & preferences |
Referral links — /influencer/referral-links
The link manager (src/app/influencer/(app)/referral-links/page.tsx) where an influencer generates tracked links to crawls. Visits and clicks are recorded (influencer_clicks, influencer_visits); attributed bookings drive influencer_commissions.
© CreativeCape Solutions · creative-cape.com · support@creative-cape.com