π€ Welcome to the Wild WEST - Grida WEST for Referral Campaigns
Your fun, flexible, and powerful referral engine.
Grida WEST is a next-gen referral campaign platform designed to help marketers launch campaigns that grow fast and reward better β without depending on devs. But donβt worry, developers get a fully structured and secure backend to plug into, too.
β¨ What You Can Buildβ
πͺ The Milestone Referralβ
Example: "Invite 5 friends, get $5 credit. Invite 10, get $15 credit."
Create campaigns with increasing rewards. Participants feel progress, and the excitement builds as they reach the next goal. Think gamified referral ladders.
π The Startup Prelaunch Waitlistβ
Example: "Refer friends to move up the list."
Perfect for launches. You get early buzz and viral sharing. Invitees jump the queue by bringing in friends.
π¬ The Newsletter Referralβ
Example: "Refer 3 friends and unlock our Pro Series."
Reward readers with content, coupons, or swag when they share your newsletter. Integrates well with Mailchimp, Beehiiv, etc.
π The Viral Giveawayβ
Example: "Enter the giveaway. Get more chances by inviting friends."
Amplify your giveaway reach. Track who referred whom, and boost chances dynamically. Rewards can be lucky draws, digital items, or just bragging rights.
ποΈ Shopify Campaignsβ
Example: "Refer a friend. You both get 10% off."
Install WEST on your store and launch a 2-sided referral program that tracks to checkout. Works well with custom logic and rewards (e.g. points, credits, coupons).
π€ The 2-Sided Classicβ
Example: "Refer your friend, you get $10, they get $5."
Invite codes can be public or private. WEST supports both self-invite and referrer-invite flows. You choose who sees what.
π§° How It All Worksβ
At the heart of every WEST campaign:
ποΈ Referrerβ
- A customer or user who shares a referral code.
- Has a unique code tied to the campaign.
- Can be limited to X invites.
π© Invitationβ
- A trackable link/code that the invitee uses.
- Can be refreshed (securely) before itβs claimed.
- Once claimed, invitee becomes part of the campaign.
πͺ Rewardsβ
- Milestone rewards: when a referrer hits X invites.
- Onboarding rewards: given to the invitee after completing a quest.
- All rewards are issued as exchange tokens, which are claimable later.
π§© Challenges / Questsβ
- Define the required actions to complete an onboarding.
- Examples: "Sign up", "Make a purchase", "Verify email", etc.
- You can chain these with dependencies.
π Analyticsβ
- Real-time logs of every tracked event.
- Visual breakdowns of event frequency, campaign growth, and referral chains.
π Built-In Pagesβ
- Landing pages for sharing
- Customer dashboard to track progress
- Optional public leaderboards
π FAQβ
Q: Can anyone start a campaign?β
Yes, as long as youβre a project owner. You can create, enable/disable, and manage all campaigns tied to your project.
Q: Can I hide the invitee's or referrerβs info?β
Yes. You control if their name or avatar is exposed. By default, we hide them unless explicitly allowed.
Q: Can a user invite themselves?β
Yes β if you want. In self-invite mode, they use a public code to generate their own invitation.
Q: What if I want the referrer to create invitations?β
You can do that too. Thatβs the referrer-invite mode. They create the invite and share it directly.
Q: Can I refresh or regenerate invite links?β
Yes. Unclaimed invitations can be refreshed with a new code β old codes become invalid.
Q: Is this secure?β
Yes. All campaign logic is enforced at the database level with Row-Level Security (RLS). Codes are always tied to a campaign context.
π§ Advanced Capabilitiesβ
WEST is built on PostgreSQL with Supabase, and provides a secure, extensible data model for devs.
π‘οΈ Full RLS Enforcementβ
Every table has RLS enabled. Access is scoped per campaign/project. Safe for multitenant and public usage.
π Unique Code Handlingβ
All codes (referrer or invitee) are guaranteed to be unique within a campaign. They are stored in a dedicated code
registry table with triggers.
π¬ Event Hooks via track()
β
Track any user activity by calling the track()
function. Logs are recorded in event_log
, a hypertable that supports time-based analytics.
π Built-in Analysis APIβ
Use analyze()
to get time-bucketed stats by event name. Great for dashboards and funnel visualization.
π§ͺ Rewards as Exchange Tokensβ
Reward definitions are decoupled from actual redemption. Think of them as "earned" but not yet "delivered" β useful for managing inventory or prizes.
π§± Invite Flow Functionsβ
All key flows are handled via SQL functions:
invite()
β create a new invitationrefresh()
β regenerate invitation codeclaim()
β mark an invitation as claimedflag()
β log progress on quests/challenges
πΌ For Developers / Integrationβ
- Use the SQL functions directly from Supabase or REST/RPC endpoints.
- Schema:
grida_west_referral
- Tables:
campaign
,referrer
,invitation
,onboarding
,event_log
, etc. - Views for public use:
referrer_public_secure
,invitation_public_secure
,campaign_public
- Docs coming soon on webhook integrations and Zapier-compatible flows.
π Final Thoughtsβ
Grida WEST gives you the flexibility of a headless referral engine, the safety of a battle-tested schema, and the joy of setting up campaigns without drowning in code.
Launch your first campaign today.
Track it. Share it. Reward your champions.
The WEST is wild β but now itβs yours.
𧨠Letβs ride.