@tribe-nest/forge 3.59.0 → 3.60.0

package/src/i18n/en.json

@@ -655,6 +655,118 @@
   "forge.cohort_page.date_range": "{start} to {end}",
   "forge.cohort_page.date_tbd": "TBD",
   "forge.cohort_page.not_found": "Cohort not found.",
+  "forge.communities_list.empty": "There are no communities to join yet.",
+  "forge.communities_list.heading": "Communities",
+  "forge.communities_list.member_count": "{count} members",
+  "forge.community_about.apply": "Apply to join",
+  "forge.community_about.current_tier": "Your current tier",
+  "forge.community_about.go_inside": "Go to the community",
+  "forge.community_about.join": "Join",
+  "forge.community_about.join_free": "Join free",
+  "forge.community_about.join_from": "Join from {amount}/mo",
+  "forge.community_about.join_from_yearly": "Join from {amount}/yr",
+  "forge.community_about.join_tier": "Join",
+  "forge.community_about.member_count": "{count} members",
+  "forge.community_about.not_found": "This community could not be found.",
+  "forge.community_about.pending": "Your application is being reviewed.",
+  "forge.community_about.tiers_title": "Membership tiers",
+  "forge.community_about.view_application": "View your application",
+  "forge.community_home.confirming": "Confirming your membership...",
+  "forge.community_home.dismiss": "Dismiss",
+  "forge.community_home.join": "Join",
+  "forge.community_home.membership": "Membership",
+  "forge.community_home.not_found": "This community could not be found.",
+  "forge.community_home.upgrade": "Upgrade",
+  "forge.community_home.welcome": "Welcome to {community_name}!",
+  "forge.community_join_sheet.accept_terms": "I accept the Terms and Privacy Policy",
+  "forge.community_join_sheet.already_member": "You are already a member.",
+  "forge.community_join_sheet.amount_below_minimum": "The minimum is {minimum}.",
+  "forge.community_join_sheet.amount_label": "Choose your amount (minimum {minimum})",
+  "forge.community_join_sheet.amount_not_positive": "Enter an amount above zero.",
+  "forge.community_join_sheet.answer_required": "Please answer: {question}",
+  "forge.community_join_sheet.apply": "Apply to join",
+  "forge.community_join_sheet.aria_close": "Close",
+  "forge.community_join_sheet.back": "Back",
+  "forge.community_join_sheet.billing_cycle": "Billing cycle",
+  "forge.community_join_sheet.card_application": "Add a card for your application",
+  "forge.community_join_sheet.card_application_help": "Your card is saved, not charged. You are charged only if your application is approved.",
+  "forge.community_join_sheet.card_application_help_label": "When is my card charged?",
+  "forge.community_join_sheet.card_payment": "Pay {amount}",
+  "forge.community_join_sheet.card_trial": "Add a card to start your free trial",
+  "forge.community_join_sheet.change_tier": "Change tier",
+  "forge.community_join_sheet.choose_tier": "Choose a tier",
+  "forge.community_join_sheet.code": "6-digit code",
+  "forge.community_join_sheet.code_sent": "We emailed a 6-digit code to {email}.",
+  "forge.community_join_sheet.continue": "Continue",
+  "forge.community_join_sheet.email": "Email",
+  "forge.community_join_sheet.email_mismatch": "This invite is for {email}. You are signed in as {signed_in_email}.",
+  "forge.community_join_sheet.first_name": "First name",
+  "forge.community_join_sheet.invite_expired": "This invite has expired. You can still join below.",
+  "forge.community_join_sheet.invite_not_found": "This invite link is not valid. You can still join below.",
+  "forge.community_join_sheet.invite_revoked": "This invite was withdrawn. You can still join below.",
+  "forge.community_join_sheet.invite_used": "This invite has already been used. You can still join below.",
+  "forge.community_join_sheet.invite_used_up": "This invite link has no places left. You can still join below.",
+  "forge.community_join_sheet.join_for": "Join for {amount}",
+  "forge.community_join_sheet.join_free": "Join free",
+  "forge.community_join_sheet.joined_title": "You're in!",
+  "forge.community_join_sheet.joining": "Joining...",
+  "forge.community_join_sheet.last_name": "Last name",
+  "forge.community_join_sheet.mode_signin": "Sign in",
+  "forge.community_join_sheet.mode_signup": "Create account",
+  "forge.community_join_sheet.monthly": "Monthly",
+  "forge.community_join_sheet.monthly_price": "Monthly, {amount}",
+  "forge.community_join_sheet.password": "Password",
+  "forge.community_join_sheet.pay": "Pay {amount}",
+  "forge.community_join_sheet.pending_body": "Your application is being reviewed. We'll let you know when it is decided.",
+  "forge.community_join_sheet.pending_title": "Application sent",
+  "forge.community_join_sheet.resend": "Resend code",
+  "forge.community_join_sheet.select_placeholder": "Select...",
+  "forge.community_join_sheet.sign_in_as": "Sign in as {email}",
+  "forge.community_join_sheet.start_trial": "Start free trial",
+  "forge.community_join_sheet.taking_you_inside": "Taking you inside...",
+  "forge.community_join_sheet.title": "Join {community_name}",
+  "forge.community_join_sheet.title_plain": "Join",
+  "forge.community_join_sheet.trial_line": "{days}-day free trial, first charge on {date}",
+  "forge.community_join_sheet.verify": "Verify",
+  "forge.community_join_sheet.working": "Please wait...",
+  "forge.community_join_sheet.yearly": "Yearly",
+  "forge.community_join_sheet.yearly_price": "Yearly, {amount}",
+  "forge.community_membership_menu.aria_close": "Close",
+  "forge.community_membership_menu.cancel": "Cancel membership",
+  "forge.community_membership_menu.cancel_confirm": "Cancel membership",
+  "forge.community_membership_menu.cancel_confirm_now": "Your membership ends now.",
+  "forge.community_membership_menu.cancel_confirm_title": "Cancel your membership?",
+  "forge.community_membership_menu.cancel_confirm_until": "You keep access until {date}. It will not renew.",
+  "forge.community_membership_menu.cancel_keep": "Keep membership",
+  "forge.community_membership_menu.downgrade_to": "Switch to {tier_name} at renewal",
+  "forge.community_membership_menu.ending": "Ending",
+  "forge.community_membership_menu.ends_on": "Ends on {date}",
+  "forge.community_membership_menu.payment_failed": "Payment failed",
+  "forge.community_membership_menu.pending_downgrade": "Switching to {tier_name} on {date}.",
+  "forge.community_membership_menu.renews_on": "Renews on {date}",
+  "forge.community_membership_menu.title": "Your membership",
+  "forge.community_membership_menu.trigger": "Membership",
+  "forge.community_membership_menu.undo_downgrade": "Keep my current tier",
+  "forge.community_membership_menu.update_card": "Update payment method",
+  "forge.community_membership_menu.upgrade": "Upgrade",
+  "forge.community_pending.body": "Your application is being reviewed. You'll get access as soon as it is approved.",
+  "forge.community_pending.body_since": "You applied on {date}. You'll get access as soon as it is approved.",
+  "forge.community_pending.title": "Your application is being reviewed",
+  "forge.community_upgrade_sheet.aria_close": "Close",
+  "forge.community_upgrade_sheet.back": "Back",
+  "forge.community_upgrade_sheet.charge_now": "You pay {amount} now.",
+  "forge.community_upgrade_sheet.charge_prorated": "You pay {amount} now for the rest of this period.",
+  "forge.community_upgrade_sheet.confirm": "Upgrade now",
+  "forge.community_upgrade_sheet.continue_to_card": "Continue to card",
+  "forge.community_upgrade_sheet.current": "You are on {tier_name}.",
+  "forge.community_upgrade_sheet.done": "Upgraded!",
+  "forge.community_upgrade_sheet.none": "You are already on the highest tier.",
+  "forge.community_upgrade_sheet.pay": "Pay and upgrade",
+  "forge.community_upgrade_sheet.price_monthly": "{amount}/mo",
+  "forge.community_upgrade_sheet.price_yearly": "{amount}/yr",
+  "forge.community_upgrade_sheet.requires_card": "Upgrading asks for your card again and replaces your current subscription.",
+  "forge.community_upgrade_sheet.title": "Upgrade",
+  "forge.community_upgrade_sheet.unlock_with": "Unlock with {tier_name}",
   "forge.confirm_subscription.back_to_site": "Back to site",
   "forge.confirm_subscription.expired_body": "This confirmation link is no longer valid. Try subscribing again.",
   "forge.confirm_subscription.expired_title": "Link expired",
@@ -1167,6 +1279,19 @@
   "forge.login_form.verify_submit": "Verify & Sign In",
   "forge.login_form.verify_title": "Verify your email",
   "forge.login_form.verifying": "Verifying…",
+  "forge.member_home_layout.nav_label": "Community",
+  "forge.member_home_layout.tab_calendar": "Calendar",
+  "forge.member_home_layout.tab_chat": "Chat",
+  "forge.member_home_layout.tab_collections": "Collections",
+  "forge.member_home_layout.tab_leaderboard": "Leaderboard",
+  "forge.member_home_layout.tab_notifications": "Notifications",
+  "forge.member_home_layout.tab_posts": "Posts",
+  "forge.member_home_layout.tab_spaces": "Spaces",
+  "forge.member_post_card.locked_body": "Join to access this content",
+  "forge.member_post_card.locked_body_tier": "Unlock with {tier_name} to access this content",
+  "forge.member_post_card.locked_title": "Content locked",
+  "forge.member_post_card.unlock": "Unlock",
+  "forge.member_post_card.unlock_with": "Unlock with {tier_name}",
   "forge.membership_checkout.accept_invite": "Accept invite",
   "forge.membership_checkout.amount_below_minimum": "Enter {minimum} or more.",
   "forge.membership_checkout.amount_not_positive": "Enter an amount greater than zero.",
@@ -1203,7 +1328,7 @@
   "forge.membership_checkout.empty_title": "No memberships available",
   "forge.membership_checkout.field_required": "This field is required",
   "forge.membership_checkout.free": "Free",
-  "forge.membership_checkout.go_to_account": "Go to your account",
+  "forge.membership_checkout.go_to_community": "Go to the community",
   "forge.membership_checkout.invite_dead_body": "It may have expired, been used already, or been replaced by a newer invite. Ask us for a new one.",
   "forge.membership_checkout.invite_dead_title": "This invite is no longer valid",
   "forge.membership_checkout.invite_email_mismatch": "You're signed in as {signed_in_email}. Sign in with {email} to accept this invite.",
@@ -1235,6 +1360,7 @@
   "forge.membership_tier_callout.invite_for_email": "This invite is for {email}. Sign in or create an account with that address.",
   "forge.membership_tier_callout.join_title": "Join {tier_name}",
   "forge.membership_tier_callout.more_benefits": "+{count} more benefits",
+  "forge.membership_tier_callout.view_community": "Part of {community_name}",
   "forge.membership_tiers.accept_invite": "Accept invite",
   "forge.membership_tiers.application_approved": "Approved, finishing up",
   "forge.membership_tiers.application_declined": "Not approved",
@@ -1255,6 +1381,14 @@
   "forge.membership_tiers.withdraw": "Withdraw application",
   "forge.membership_tiers.withdraw_error": "We couldn't withdraw your application. Please try again.",
   "forge.membership_tiers.withdrawing": "Withdrawing…",
+  "forge.my_memberships_list.cycle_month": "month",
+  "forge.my_memberships_list.cycle_year": "year",
+  "forge.my_memberships_list.empty": "You are not a member of any community yet.",
+  "forge.my_memberships_list.ends_on": "Ends on {date}",
+  "forge.my_memberships_list.open": "Open community",
+  "forge.my_memberships_list.price": "{amount} per {cycle}",
+  "forge.my_memberships_list.renews_on": "Renews on {date}",
+  "forge.my_memberships_list.trial_until": "Free trial until {date}",
   "forge.offer_button.buy_now": "Buy now",
   "forge.offer_button.confirm_email": "Confirm email",
   "forge.offer_button.continue_to_payment": "Continue to payment",
@@ -1310,6 +1444,16 @@
   "forge.podcast_show.empty_title": "No episodes yet.",
   "forge.podcast_show.not_found": "Podcast not found.",
   "forge.podcast_show.now_playing": "Now playing",
+  "forge.post_collection_detail.locked_body": "Join to access this content",
+  "forge.post_collection_detail.locked_body_tier": "Unlock with {tier_name} to access this content",
+  "forge.post_collection_detail.locked_title": "Content locked",
+  "forge.post_collection_detail.unlock": "Unlock",
+  "forge.post_collection_detail.unlock_with": "Unlock with {tier_name}",
+  "forge.post_collections_grid.locked_body": "Join to access this content",
+  "forge.post_collections_grid.locked_body_tier": "Unlock with {tier_name} to access this content",
+  "forge.post_collections_grid.locked_title": "Content locked",
+  "forge.post_collections_grid.unlock": "Unlock",
+  "forge.post_collections_grid.unlock_with": "Unlock with {tier_name}",
   "forge.posts_feed.empty_body": "No posts yet.",
   "forge.presale_code.checking": "Checking…",
   "forge.presale_code.input_placeholder": "Enter code",

package/src/index.ts

@@ -1,8 +1,8 @@
-// Forge — the headless React SDK for TribeNest creator sites.
+// Forge: the headless React SDK for TribeNest creator sites.
 //
 // Phase 1 (the spine): client factory, root provider, core types.
 // Subsequent phases add providers (auth/cart/audio), data hooks, flow hooks,
-// headless blocks, and SEO — see docs/code-websites-initiative.md.
+// headless blocks, and SEO: see docs/code-websites-initiative.md.
 
 export { createForgeClient, getForgeWebSocketUrl } from "./client/createForgeClient";
 export type { ForgeClientOptions } from "./client/createForgeClient";
@@ -43,12 +43,12 @@ export {
 // All domain types + enums/consts (models) and WebPage.
 export * from "./types";
 
-// Providers (Phase 2 — moving from frontend-shared into Forge)
+// Providers (Phase 2: moving from frontend-shared into Forge)
 export { AudioPlayerProvider, useAudioPlayer } from "./contexts/AudioPlayerContext";
 export type { AudioTrack } from "./contexts/AudioPlayerContext";
 export { CartProvider, useCart } from "./contexts/CartContext";
 // Variant selection, shared with the Craft themes in frontend-shared the same
-// way the cart and audio player are — so a code site and a Craft site cannot
+// way the cart and audio player are: so a code site and a Craft site cannot
 // disagree about which version a buyer picked.
 export { useVariantSelection } from "./ui/headless/useVariantSelection";
 // Which version a cart line is. Exported from the package root because the
@@ -66,7 +66,7 @@ export {
 export type { AuthActions } from "./contexts/PublicAuthContext";
 export { PUBLIC_REFRESH_TOKEN_KEY, APP_REFRESH_TOKEN_KEY } from "./client/tokenStorage";
 export { safeRedirectPath } from "./utils/safeRedirect";
-// Ticket-confirmation copy decision — shared so the Forge block and the client
+// Ticket-confirmation copy decision: shared so the Forge block and the client
 // app's finalise page can never tell a refunded buyer two different stories.
 export {
   getTicketOrderOutcome,
@@ -89,7 +89,7 @@ export {
 } from "./contexts/AppAuthContext";
 export { useAppAdminGuard, type AppAdminGuardResult } from "./contexts/useAppAdminGuard";
 
-// Data hooks (React Query) — Phase 3
+// Data hooks (React Query): Phase 3
 export * from "./data/queries/useProducts";
 export * from "./data/queries/useMembership";
 export * from "./data/queries/useCourses";
@@ -151,13 +151,25 @@ export * from "./data/queries/useCallChat";
 export * from "./data/queries/useCallBreakouts";
 export * from "./data/queries/useAnalytics";
 export * from "./data/queries/useCommunity";
+// Communities: the list, one community, the viewer's state in it, invites,
+// upgrades and the fan's memberships across communities.
+export * from "./data/queries/useCommunities";
+// The provider every member-content hook reads its community from.
+export {
+  CommunityProvider,
+  useCommunityContext,
+  useOptionalCommunityContext,
+  MissingCommunityProviderError,
+  type CommunityContextValue,
+  type CommunityProviderProps,
+} from "./contexts/CommunityContext";
 export * from "./data/queries/useReviews";
 export * from "./data/queries/useDocuments";
 export * from "./data/queries/useNotifications";
 export * from "./data/queries/usePWA";
 export * from "./data/queries/useCertificates";
 
-// Content layer (Phase E) — typed/editable/localizable site content
+// Content layer (Phase E): typed/editable/localizable site content
 export * from "./content";
 
 // Utils

package/src/runtime/pages.spec.ts

@@ -38,4 +38,35 @@ describe("internal page links", () => {
   it("carries every page exactly once", () => {
     expect(new Set(INTERNAL_PAGES).size).toBe(INTERNAL_PAGES.length);
   });
+
+  it("carries exactly the community pages, and none of the removed single-community ones", () => {
+    const community = INTERNAL_PAGES.filter((page) => page.startsWith("communities"));
+    expect(community).toEqual([
+      "communities",
+      "communities/$slug",
+      "communities/$slug/home",
+      "communities/$slug/home/calendar",
+      "communities/$slug/home/chat",
+      "communities/$slug/home/collections",
+      "communities/$slug/home/collections/$collectionId",
+      "communities/$slug/home/leaderboard",
+      "communities/$slug/home/notifications",
+      "communities/$slug/home/posts",
+      "communities/$slug/home/profile/$accountId",
+      "communities/$slug/home/spaces",
+      "communities/$slug/home/spaces/$spaceId",
+      "communities/$slug/home/spaces/posts/$postId",
+    ]);
+    const removed = INTERNAL_PAGES.filter((page) => /^(membership|members|community|chat)(\/|$)/.test(page));
+    expect(removed).toEqual([]);
+  });
+
+  it("builds community paths with the slug and recognises them", () => {
+    expect(internalPath("communities/$slug/home/spaces/posts/$postId", { slug: "fan-club", postId: "p1" })).toBe(
+      "/i/communities/fan-club/home/spaces/posts/p1",
+    );
+    expect(isInternalPage("communities/fan-club/home")).toBe(true);
+    expect(isInternalPage("members/spaces")).toBe(false);
+    expect(isInternalPage("membership/checkout")).toBe(false);
+  });
 });

package/src/runtime/pages.ts

@@ -7,9 +7,13 @@
  * for TanStack to know about. That is the reason this helper exists, and it is
  * why the build guide forbids writing an `/i/` path by hand.
  *
- * The page list is the CONTRACT between a site and the hosted pages, so it only
- * ever grows. Removing a page breaks links on sites already published, so a
- * retired page keeps its entry and redirects.
+ * The page list is the CONTRACT between a site and the hosted pages, so it
+ * normally only grows: removing a page breaks links on sites already published.
+ * The one deliberate exception is Communities (2026-09-27). A profile can now
+ * run several communities, so the single-community member pages (`membership`,
+ * `members/*`, `community/*`, `chat`) were removed with no redirects, because
+ * nobody used them yet and there is no one community they could redirect to.
+ * Every member page now lives under `communities/$slug`.
  *
  *     <Link {...internalLink("store/$slug", { slug: product.slug })}>Buy</Link>
  *     navigate(internalLink("checkout"))
@@ -28,7 +32,6 @@ export const INTERNAL_PAGES = [
   "blog",
   "blog-category/$slug",
   "blog/$slug",
-  "chat",
   "checkout",
   "checkout/finalise",
   "checkout/resume",
@@ -37,11 +40,20 @@ export const INTERNAL_PAGES = [
   "coaching/$slug/finalise",
   "cohorts/$cohortId",
   "cohorts/$cohortId/finalise",
-  "community",
-  "community/leaderboard",
-  "community/notifications",
-  "community/posts/$postId",
-  "community/spaces/$spaceId",
+  "communities",
+  "communities/$slug",
+  "communities/$slug/home",
+  "communities/$slug/home/calendar",
+  "communities/$slug/home/chat",
+  "communities/$slug/home/collections",
+  "communities/$slug/home/collections/$collectionId",
+  "communities/$slug/home/leaderboard",
+  "communities/$slug/home/notifications",
+  "communities/$slug/home/posts",
+  "communities/$slug/home/profile/$accountId",
+  "communities/$slug/home/spaces",
+  "communities/$slug/home/spaces/$spaceId",
+  "communities/$slug/home/spaces/posts/$postId",
   "confirm-subscription",
   "course-access/$accessId",
   "courses",
@@ -65,19 +77,6 @@ export const INTERNAL_PAGES = [
   "live",
   "live/$broadcastId",
   "login",
-  "members",
-  "members/calendar",
-  "members/chat",
-  "members/collections",
-  "members/collections/$slug",
-  "members/spaces",
-  "members/spaces/$slug",
-  "members/spaces/leaderboard",
-  "members/spaces/notifications",
-  "members/spaces/profile/$accountId",
-  "members/spaces/thread/$postId",
-  "membership",
-  "membership/checkout",
   "payment-link/$paymentLinkId",
   "payment-link/$paymentLinkId/finalise",
   "podcasts",

package/src/server/_tests/buildWebManifest.spec.ts

@@ -270,7 +270,7 @@ describe("buildWebManifest — name/short_name fallback chain", () => {
 describe("buildWebManifest — overrides (shortcuts) merge", () => {
   const overrides: BuildWebManifestOptions["overrides"] = {
     shortcuts: [
-      { name: "Members", short_name: "Members", url: "/i/members" },
+      { name: "Members", short_name: "Members", url: "/i/communities" },
       { name: "Account", short_name: "Account", url: "/i/account" },
     ],
   };

package/src/server/_tests/forgeServiceWorkerScript.spec.ts

@@ -168,7 +168,7 @@ describe("forgeServiceWorkerScript — push payload contract (frozen, shared wit
           title: "New message",
           body: "hey!",
           type: "chat_message",
-          url: "/i/chat/42",
+          url: "/i/communities/fan-club/home/chat",
           profileId: "prof-1",
           channelId: "chan-9",
           icon: "https://cdn.tribenest.co/p/nova/icon-192.png",
@@ -181,7 +181,7 @@ describe("forgeServiceWorkerScript — push payload contract (frozen, shared wit
       body: "hey!",
       icon: "https://cdn.tribenest.co/p/nova/icon-192.png",
       tag: "chat-chan-9",
-      data: { url: "/i/chat/42", type: "chat_message" },
+      data: { url: "/i/communities/fan-club/home/chat", type: "chat_message" },
     });
   });
 
@@ -229,9 +229,9 @@ describe("forgeServiceWorkerScript — notificationclick", () => {
   it("focuses an existing client matching the deep-link URL", async () => {
     const { handlers, matchAll, openWindow } = loadSw();
     const focus = vi.fn(() => ({}));
-    matchAll.mockResolvedValueOnce([{ url: "https://nova.tribenest.co/i/chat/42", focus }]);
+    matchAll.mockResolvedValueOnce([{ url: "https://nova.tribenest.co/i/communities/fan-club/home/chat", focus }]);
     const close = vi.fn();
-    const event = fakeEvent({ notification: { close, data: { url: "/i/chat/42" } } });
+    const event = fakeEvent({ notification: { close, data: { url: "/i/communities/fan-club/home/chat" } } });
     handlers.notificationclick!(event);
     await event.waited;
     expect(close).toHaveBeenCalledOnce();

package/src/ui/format/_tests/membershipGate.spec.ts

@@ -72,7 +72,7 @@ describe("parseMembershipGateError", () => {
     });
   });
 
-  it("matches on CODE, not on status — a read refusal is 401/403, a checkout refusal 400", () => {
+  it("matches on CODE, not on status: a read refusal is 401/403, a checkout refusal 400", () => {
     // Nothing here reads a status at all; the same payload parses whichever
     // status carried it. A client switching on 401 would render this as a
     // session timeout.
@@ -113,7 +113,7 @@ describe("joinTierNames", () => {
     expect(joinTierNames(["Gold", "Silver", "Bronze"])).toBe("Gold, Silver or Bronze");
   });
 
-  it("drops blanks — an unresolved tier must not become an empty slot", () => {
+  it("drops blanks: an unresolved tier must not become an empty slot", () => {
     expect(joinTierNames(["", "  ", "Gold"])).toBe("Gold");
     expect(joinTierNames([])).toBe("");
   });
@@ -160,18 +160,18 @@ describe("buildMembershipGateNotice", () => {
     expect(notice!.body).toBe("This ticket is for Gold members. Already one? Sign in and it unlocks.");
   });
 
-  it("offers the TIER to someone already signed in — never sign-in again", () => {
+  it("offers the TIER to someone already signed in: never sign-in again", () => {
     const notice = buildMembershipGateNotice({
       gate: gate({ reason: "membership_required", requiredTierIds: ["gold", "plat"] }),
       tierNames: ["Gold", "Platinum"],
       itemLabel: "This course",
-      membershipPath: "/i/membership",
+      membershipPath: "/i/communities/fan-club?tier=gold",
     });
 
     expect(notice).toMatchObject({
       reason: "membership_required",
       actionLabel: "View Gold or Platinum",
-      actionHref: "/i/membership",
+      actionHref: "/i/communities/fan-club?tier=gold",
     });
     expect(notice!.body).toBe("This course is for Gold or Platinum members. Your current plan doesn't include it.");
     // Telling a signed-in member to sign in is a loop with no exit.
@@ -214,7 +214,7 @@ describe("buildMembershipGateNotice", () => {
   });
 
   it("uses default paths when the host names none", () => {
-    expect(buildMembershipGateNotice({ gate: gate() })!.actionHref).toBe("/membership");
+    expect(buildMembershipGateNotice({ gate: gate() })!.actionHref).toBe("/i/communities");
     expect(buildMembershipGateNotice({ gate: gate({ reason: "sign_in_required" }) })!.actionHref).toBe("/login");
   });
 });

package/src/ui/format/membershipGate.ts

@@ -8,22 +8,22 @@ import type { MembershipGateReason, PublicMembershipGate } from "../../types/mod
  *
  * The gate shipped ENFORCED and UNANNOUNCED. A logged-out buyer saw an ordinary
  * ticket, chose a seat, typed their name and their email twice, and was refused
- * on the last screen with a `MEMBERSHIP_GATE` 400 — the restriction was
+ * on the last screen with a `MEMBERSHIP_GATE` 400: the restriction was
  * discoverable only by failing it. And the "members save X, sign in" funnel the
  * feature was justified by existed on no surface at all, because nothing drew a
  * way OUT of the refusal.
  *
  * ## Why it is pure, and why it lives in `format/`
  *
- * There are two rendering stacks — `apps/client` and the Forge SDK that code
- * websites build against — and a members-only badge that says one thing on an
+ * There are two rendering stacks (`apps/client` and the Forge SDK that code
+ * websites build against), and a members-only badge that says one thing on an
  * artist's PWA and another on their website is the same bug twice. So the words
  * and the resolving ACTION are decided once, here, with no React and no client;
  * each stack owns only how it looks. `apps/client` imports this from
  * `@tribe-nest/forge/ui`, exactly as it already does for the PWYW arithmetic.
  *
  * Pure and total also means the whole mapping is testable without a DOM or a
- * session — and getting the two reasons backwards is the failure mode that
+ * session, and getting the two reasons backwards is the failure mode that
  * matters most: telling someone who is already signed in to "sign in" is a loop
  * with no exit, and telling a logged-out visitor to "upgrade" asks them to buy a
  * membership they may already hold.
@@ -94,7 +94,7 @@ export function parseMembershipGateError(error: unknown): MembershipGateRefusal
 /**
  * Is this thing refused to the caller looking at it?
  *
- * `null` means "nothing gates it" — which is also what every read returns while
+ * `null` means "nothing gates it", which is also what every read returns while
  * the `membership_entitlement_gates` switch is off. Treating an absent gate as
  * "gated and permitted" would badge every item on every site the day the field
  * shipped, so absent must read as false here and nowhere else.
@@ -110,7 +110,7 @@ export type MembershipGateNotice = {
   badge: string;
   title: string;
   body: string;
-  /** Primary CTA label — the way OUT of the refusal, which is the whole point. */
+  /** Primary CTA label: the way OUT of the refusal, which is the whole point. */
   actionLabel: string;
   /**
    * Where the CTA goes. `null` only when the caller passed no path to send them
@@ -120,12 +120,16 @@ export type MembershipGateNotice = {
   actionHref: string | null;
 };
 
-/** Default sign-in path. Overridden per site — code websites mount theirs under `/i`. */
+/** Default sign-in path. Overridden per site: code websites mount theirs under `/i`. */
 export const MEMBERSHIP_GATE_LOGIN_PATH = "/login";
-/** Default tier-listing path, i.e. where "become a member" actually leads. */
-export const MEMBERSHIP_GATE_MEMBERSHIP_PATH = "/membership";
+/**
+ * Default "become a member" path when the tier's community is not known: the
+ * communities list. `useMembershipGateNotice` sends the buyer to the About page
+ * of the community the required tier belongs to, with that tier preselected.
+ */
+export const MEMBERSHIP_GATE_MEMBERSHIP_PATH = "/i/communities";
 
-/** "Gold", "Gold or Platinum", "Gold, Silver or Bronze" — ANY one unlocks, hence "or". */
+/** "Gold", "Gold or Platinum", "Gold, Silver or Bronze". ANY one unlocks, hence "or". */
 export function joinTierNames(names: string[]): string {
   const clean = names.map((name) => name.trim()).filter(Boolean);
   if (clean.length === 0) return "";
@@ -133,7 +137,7 @@ export function joinTierNames(names: string[]): string {
   return `${clean.slice(0, -1).join(", ")} or ${clean[clean.length - 1]}`;
 }
 
-/** `path?redirect=<here>` — a sign-in that lands back on the thing they wanted. */
+/** `path?redirect=<here>`: a sign-in that lands back on the thing they wanted. */
 export function membershipSignInHref(loginPath: string, currentPath: string): string {
   const target = safeRedirectPath(currentPath, "");
   return target ? `${loginPath}?redirect=${encodeURIComponent(target)}` : loginPath;
@@ -142,7 +146,7 @@ export function membershipSignInHref(loginPath: string, currentPath: string): st
 export interface BuildMembershipGateNoticeInput {
   /** The announced gate from a listing/detail read. */
   gate?: PublicMembershipGate | null;
-  /** A `MEMBERSHIP_GATE` refusal from a failed purchase. Wins over `gate` — it is the newer fact. */
+  /** A `MEMBERSHIP_GATE` refusal from a failed purchase. Wins over `gate`: it is the newer fact. */
   refusal?: MembershipGateRefusal | null;
   /**
    * Names for `requiredTierIds`, already resolved by the caller (both stacks
@@ -150,7 +154,7 @@ export interface BuildMembershipGateNoticeInput {
    * 8f3c-…" is not a sentence anyone can act on.
    */
   tierNames?: string[];
-  /** What the thing IS, in the buyer's words — "This ticket", "This course". */
+  /** What the thing IS, in the buyer's words: "This ticket", "This course". */
   itemLabel?: string;
   loginPath?: string;
   membershipPath?: string;
@@ -185,7 +189,7 @@ export function buildMembershipGateNotice(
       // The API's own sentence is deliberately NOT used for this half. It is
       // written for the refusal ("You must be a member to buy this"), and what
       // an anonymous visitor needs first is the possibility that they already
-      // are one — which is the difference between a dead end and a funnel.
+      // are one, which is the difference between a dead end and a funnel.
       body: tiers
         ? `${item} is for ${tiers} members. Already one? Sign in and it unlocks.`
         : `${item} is for members. Already one? Sign in and it unlocks.`,
@@ -201,7 +205,7 @@ export function buildMembershipGateNotice(
     body: tiers
       ? `${item} is for ${tiers} members. Your current plan doesn't include it.`
       : `${item} is for members. Your current plan doesn't include it.`,
-    // NOT "sign in" — they already are, and offering it again is a loop with no
+    // NOT "sign in": they already are, and offering it again is a loop with no
     // exit. The only move that changes anything is joining the tier.
     actionLabel: tiers ? `View ${tiers}` : "View membership",
     actionHref: membershipPath,