Welcome to Pocket Portal!

Run with Remix

• Remix Docs

Deployment

PR / DEV

Create PR and vercel will create a preview build based on the PR

STAGE

Merge PR into "stage" branch and vercel will build to staging environment

PROD

Merge PR from "stage" to "main" and vercel will build to prod environment

Development

Frontend

To run your Remix app locally, make sure your project's local dependencies are installed:

pnpm install

Afterwards, start the Remix development server like so:

pnpm run dev

Open up http://localhost:3000 and you should be ready to go!

If you're used to using the vercel dev command provided by Vercel CLI instead, you can also use that, but it's not needed.

Stripe Webhook Forwarding

If you wish to test the Stripe webhook flow, you must use the Stripe CLI to forward the webhook to your local environment.

Full instructions can be found on the Stripe documentation page.

You must initialize the Stripe CLI with your Stripe account:

stripe login

Then run the following to start forwarding webhooks:

stripe --api-key {STRIPE_API_KEY} listen --forward-to http://localhost:3000/api/stripe/webhook

It is generally recommended to use the test mode Stripe API key for forwarding webhooks, as this will not create any real subscriptions or charge any real money.

You will be given a webhook signing secret, set it in your .env file as STRIPE_WEBHOOK_SECRET.

The webhook handling code in this repo can be found here..

Environment Variables

You can find the environment variables - including for Stripe- here.

Backend

This currently requires you to also run the current portal backend on localhost:4200 in order to run. I am working with the backend team to whitelist localhost and enable us to hit the backend.staging.portal.pokt.network endpoints.