Skip to main content
Byg native iOS-, Android- og web-experiences til Whop med én enkelt React Native-kodebase. Dine apps kører direkte i Whops mobilapp og kan få adgang til native platformfunktioner.

Sådan fungerer det

Whop indlejrer React Native-apps som experiences, der kører på flere platforme:
  • Mobil (iOS/Android): Apps kører native i Whops mobilapp med fuld platformintegration
  • Web: Apps kører i browseren med automatiske fallbacks for platformspecifikke funktioner
  • Universel kode: Skriv én gang, udrul overalt med platformspecifikke optimeringer
Din app modtager godkendt brugerkontekst og kan foretage API-kald via Whop SDK’et. Build-systemet håndterer automatisk platformspecifik bundling med Metro til mobil og esbuild til web.

Kom i gang

Systemkrav

Før du begynder, skal du sikre dig, at dit system opfylder følgende krav: Kør node -v og pnpm -v for at tjekke.

Opret din app

Opret en ny Whop React Native-app med CLI’en:
Det opretter et nyt projekt med følgende struktur:

Konfigurer miljøvariabler

Opret en .env.local-fil i rodmappen:
Hent disse legitimationsoplysninger fra Whop Developer Dashboard:
  1. Gå til Whop Developer Dashboard
  2. Opret en ny app, eller vælg en eksisterende
  3. Kopiér miljøvariablerne fra appindstillingerne

Visninger

Projektstruktur
Whop-apps bruger forskellige “visninger” afhængigt af, hvor de vises. Hver visning modtager godkendt kontekst som props.

Experience-visning

Hovedvisningen for experience-apps. Det er her, brugerne interagerer med indholdet i din app.
Props:
  • experienceId - Experience-ID’et
  • companyId - Den konto, der ejer denne experience
  • currentUserId - Den godkendte bruger (eller null, hvis ikke logget ind)
  • path - Navigationssti som array (f.eks. ["courses", "123"])
  • params - Query-parametre som objekt

Dashboard-visning

Til integrationer i kontoens dashboard, hvor sælgere administrerer deres virksomhed.
Props:
  • companyId - Konto-ID’et
  • currentUserId - Den godkendte bruger
  • path - Navigationssti som array
  • params - Query-parametre

Discover-visning (valgfri)

Til markedsplads-/discovery-experiences, hvor brugere gennemser indhold.

Hentning af data

Brug af Whop SDK’et

Dette eksempel bruger en forældet SDK-grænseflade. Det bliver opdateret, når det nye React Native SDK udkommer.
Whop SDK’et er tilgængeligt fra starten til datahentning på klientsiden:
TanStack Query er et godt valg til datahentning, fordi det automatisk håndterer caching, indlæsningstilstande og genhentning.
Nogle SDK-operationer er “kun til serveren” og skal kaldes fra dit API. Se Quickstart for, hvilke metoder der kræver udførelse på serversiden.

Godkendte API-requests

Til operationer på serversiden skal du oprette API-ruter og kalde dem fra din React Native-app:
1

Angiv din API-basis-URL

Konfigurer din API-origin i developer dashboard under Base URL.
Base URL
2

Opret et API-endpoint

Se Quickstart for SDK-konfiguration.
3

Kald fra React Native

Brug apiOrigin til at foretage godkendte requests:
Det er vigtigt at bruge apiOrigin til godkendte requests. Det sikrer, at requests går gennem Whops proxy med korrekte godkendelsesheaders.

Eksempel: Tjek adgang til en experience

Dette eksempel på serversiden bruger en forældet SDK-grænseflade. Se Godkendelse for aktuel tokenverifikation på serversiden med @whop/sdk.

Styling

Farvetemaer

React Native har et useColorScheme-hook til at registrere enhedens farveskema. Det virker automatisk i Whop-apps:

Brug af Radix UI-farver

For et omfattende farvesystem med automatisk mørk tilstand kan du bruge useColors-hookmønsteret med Radix UI-farver:
Brug:

Brug de interne navigations-API’er til at navigere mellem skærme og vise modaler:
Whop sender path og params som props til din visningskomponent.

Gå tilbage

Vis et ark eller en modal

Hent den aktuelle rute


Platformspecifikke funktioner

Konfigurer navigationslinjens titel og beskrivelse:

Skærmretning

Styr skærmretningen:

Haptisk feedback

Giv haptisk feedback på mobile enheder:
Tilgængelige haptiske typer:
  • "selection" - Let feedback ved valg
  • "impactLight" | "impactMedium" | "impactHeavy" - Feedback ved stød
  • "notificationSuccess" | "notificationWarning" | "notificationError" - Feedback ved notifikationer

Lokal caching

Gem data lokalt på enheden:

Oplysninger om værtsappen

Hent oplysninger om Whop-appen:

Køb i appen

Modtag betalinger direkte i din app:
Se dokumentationen om at modtage betalinger for en komplet guide.

Brug af tredjepartsbiblioteker

De fleste React Native-biblioteker virker uden videre. Her er de anbefalede versioner af almindelige biblioteker:
Når du tilføjer nye biblioteker, skal du sikre dig, at de er kompatible med React Native. Nogle npm-pakker er kun til web og virker ikke på mobile platforme.

Udrulning

Byg og udrul

Kommandoen ship bygger din app til alle platforme og uploader den som et udviklingsbuild:
Byg til bestemte platforme:
Kommandoen ship udruller som et udviklingsbuild, som er sikkert at køre på eksisterende produktionsapps. Det påvirker ikke dine live brugere.

Udviklings- og produktionsbuilds

Udviklingsbuilds:
  • Udrulles med pnpm ship
  • Kun synlige, når du aktiverer Dev mode (ryst telefonen)
  • Sikre at teste uden at påvirke produktionsbrugere
  • Du kan udrulle dem når som helst
Produktionsbuilds:
  • Forfremmes fra udviklingsbuilds via dashboardet
  • Synlige for alle brugere
  • Kræver godkendelse/gennemgang
  • Test dem før forfremmelse

Forhåndsvis din app

Når du har udrullet et udviklingsbuild, kan du forhåndsvise det på din enhed:
Det genererer en QR-kode, der installerer din app.
For at forhåndsvise udviklingsbuilds skal du ryste din telefon for at aktivere Dev mode i Whop-appen. Så kan du se builds, der ikke er produktionsbuilds.

Build-kommandoer

Yderligere kommandoer til at administrere builds:

Forfremmelse til produktion

  1. Udrul et udviklingsbuild: pnpm ship
  2. Test i Dev mode (ryst for at aktivere)
  3. Gå til dit app-dashboard
  4. Gå til fanen Builds
  5. Vælg dit udviklingsbuild
  6. Vælg Promote to Production
Forfrem til produktion
Whop gennemgår din app og udruller den til alle brugere efter godkendelse.

Rollback

Fra builds-skærmen kan du også øjeblikkeligt rulle tilbage til et tidligere produktionsbuild og sende det live til alle brugere på Whop.
Rollback

Reference for kommandolinjegrænsefladen

CLI’en @whop/react-native har kommandoer til at bygge og udrulle din app:

Kommandoer

Build-processen

Når du kører pnpm ship, gør CLI’en følgende:
  1. Genererer entrypoints - Opretter platformspecifikke indgangsfiler, der registrerer dine visninger
  2. Bundler kode:
    • Mobil (iOS/Android): Bruger Metro-bundleren + Hermes-bytecode-compileren
    • Web: Bruger esbuild med React Native Web-aliasser
  3. Pakker assets - Indsamler og optimerer billeder og andre assets
  4. Uploader til Whop - Opretter et udviklingsbuild i dit app-dashboard
  5. Genererer installationslink - Giver en QR-kode til test

Build-output


Fejlfinding

Udviklingsbuild vises ikke

Problem: Du har udrullet et udviklingsbuild, men kan ikke se det i appen. Løsning: Ryst din telefon for at aktivere Dev mode. Udviklingsbuilds er kun synlige, når Dev mode er aktiv.

Build-fejl

Problem: Buildet fejler med Metro- eller esbuild-fejl. Løsninger:
  • Kør pnpm clean for at rydde build-cachen
  • Tjek, at du har installeret alle afhængigheder: pnpm install
  • Verificer Node.js-versionen: node -v (bør være 22+)
  • Tjek for syntaksfejl i dine visninger

API-requests virker ikke

Problem: API-requests returnerer 401 eller godkendelsesfejl. Løsninger:
  • Verificer, at du bruger apiOrigin fra __internal_execSync("getAppApiOrigin", {})
  • Tjek, at .env.local angiver WHOP_API_KEY
  • Bekræft, at dit API-endpoint kalder whopSdk.verifyUserToken(request.headers)
  • Verificer, at basis-URL’en er angivet korrekt i dashboardet

Visninger blev ikke fundet

Problem: Buildet lykkes, men visningerne renderes ikke. Løsninger:
  • Tjek, at visningsfilerne findes i src/views/
  • Verificer, at eksporterne matcher: export function ExperienceView(props: ExperienceViewProps)
  • Sørg for, at visningsfilerne ender på .tsx eller .jsx

Biblioteker virker ikke

Problem: Et tredjepartsbibliotek får appen til at crashe på mobil. Løsninger:
  • Verificer, at biblioteket understøtter React Native (ikke kun web)
  • Brug de anbefalede versioner fra afsnittet Brug af biblioteker
  • Tjek, om biblioteket kræver native moduler (hvis det gør og ikke er blandt de anbefalede, understøttes det ikke)

Platformspecifikke problemer

Problem: Appen virker på én platform, men ikke på en anden. Løsninger:
  • Brug Platform.OS til at registrere platformen og give fallbacks
  • Test på alle platforme før forfremmelse til produktion
  • Tjek, om du bruger platformspecifikke API’er forkert

Næste trin