Setup & Installation

Purchase

To get started, purchase the Pocketvue template from our Supersaas store.

• Price: $99 — one-time payment, yours forever
• Includes full source code (Frontend + PocketBase Hooks)
• Access to private GitHub repo

Prerequisites:

Make sure you have the following tools installed:

• Node v20 or higher
• Git
• A code editor (we recommend Cursor)

Clone the repository

git clone https://github.com/SupersaasHQ/pocketvue.git

Setting Up PocketBase Locally

1. Download the latest PocketBase binary from the official releases.
2. Unzip and run the server:

./pocketbase serve

3. Follow the terminal prompt to create a Super Admin account.
4. Go to http://127.0.0.1:8090/_/ and log in with your credentials.

Import Pocketvue Schema

1. Navigate to Settings → Import Collections
2. Download the PocketVue Schema
3. Click Load from JSON file and select pb_schema.json
4. Review and import the collections

This will set up all required collections, rules, relations, and filters.

Run the Frontend

With PocketBase running, start the frontend:

1. Navigate to the essentials-pocketvue folder
2. Install dependencies:

pnpm install

3. Add the PocketBase URL to .env:

POCKETBASE_URL=http://127.0.0.1:8090
# Will be different for production

4. Start the development server:

pnpm dev

Visit http://localhost:3000 to see Pocketvue in action.

OAuth Configuration

To enable social logins:

1. Go to the Users collection → click the gear icon → select OAuth

2. Click Options → OAuth2
3. Enable and configure your desired providers

Need help setting up Google or GitHub credentials? Watch this walkthrough:

PocketBase Hooks Setup

You’ll also get access to the pocketvue-backend repo.

These hooks handle:

• Stripe subscription and webhook
• AI Chat functionality

Add Hooks

1. Copy the pb_hooks folder into the root of your PocketBase folder
2. Restart the server:

./pocketbase serve

Environment Variables

Set the following environment variables for Stripe and OpenAI

• STRIPE_SECRET_KEY
• OPENAI_API_KEY