Next.js & PocketBase Demo that supports SSR & App Router

screencast_00000.mp4

Features

Turnstile captcha protection for login and signup pages
Basic CSRF protection for account pages
In-memory rate limiter
Protected dashboard page
Middleware

Important

The in-memory rate limiter will only work if you're deploying to a VPS. If you're hosting on something like Vercel, please remove this part.

Instructions

Pocketbase

Generate key

First, create a folder named pb_hook next to your Pocketbase executable. Inside it, create a file named main.pb.js and add the code snippet below to it. Make sure to replace your-secure-api-key-here with a long random string.

Without this key, Pocketbase will return a 403 error.

function donotLetAnyoneIn(next) {
  return (c) => {
    const header = c.request().header.get("X-POCKETBASE-API-KEY");
    const secureAPIkey = "your-secure-api-key-here";
    if (header !== secureAPIkey) {
      throw new ForbiddenError("What are you doing here?");
    }
    return next(c);
  }
}

routerUse(donotLetAnyoneIn);

Modify Users Schema

In order for the account page to work, you need to add two fields to the users collection secret (text) and secretExpire (number). These will be used in the form submission for CSRF protection.

Environment Variables

There's already a .env.example file, you only need to rename it to .env and add your values.

This demo uses CloudFlare Turnstile captcha to secure the login/signup pages. If you don't have a Cloudflare account, you'll need to sign up.

To generate your keys go to Dashboard -> Turnstile -> Add site.

# Your Pocketbase URL
PB_URL=http://127.0.0.1:6969

# Next.js website URL
WEBSITE_URL=http://localhost:3000

# Long secret key created earlier
SECURE_API_KEY=pBHsob5OszL5gD9cJT7tBKnGMQ7oTi9BmbVKLMxZdh0K7xEiOmKYqR59k8NIO7eb5LtM5Qvev9K8tLnOLvTCBnejiiR5HJ3x9BXvqLITjod7AAaeWEUT0E9I2Ti5sjO3

# Public key shipped to the browser
NEXT_PUBLIC_CLOUDFLARE_TURNSTILE_SITE_KEY=0x4AA

# Secret key used to validate the token on the server side
CLOUDFLARE_TURNSTILE_SECRET_KEY=0x4A

NEXT.JS

To install the packages:

npm run install

To run or build the app:

npm run dev

npm run build

npm run start

// will run both build and start
npm run preview

Accessing the admin dashboard

Since your pb instance now expects an API key in the header, you will no longer be able to access the admin dashboard as well.

To fix this, you'll need to pass your API key in the request header via something like Requestly.

Babylon1999 / nextjs-pocketbase-starter-ssr