@bella-baxter/next

Bella Baxter integration for Next.js (App Router) — load secrets once in instrumentation.ts and access them in any server component or API route.

⚠️ Node.js runtime only. Not compatible with the Edge runtime. For Edge routes, export secrets at deploy time with bella secrets get -o .env.production and read from process.env.

Installation

npm install @bella-baxter/next
# or
pnpm add @bella-baxter/next

Setup

1. Enable instrumentation (Next.js 14+)

// next.config.js / next.config.ts
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    instrumentationHook: true,
  },
};

export default nextConfig;

2. Initialize in instrumentation.ts

// instrumentation.ts
import { initBella } from '@bella-baxter/next';

export async function register() {
  if (process.env.NEXT_RUNTIME === 'nodejs') {
    await initBella({
      baxterUrl: process.env.BELLA_BAXTER_URL!,
      apiKey: process.env.BELLA_BAXTER_API_KEY!,
      projectSlug: 'my-app',         // or BELLA_BAXTER_PROJECT env var
      environmentSlug: 'production',  // or BELLA_BAXTER_ENV env var
    });
  }
}

3. Use anywhere server-side

// app/api/route.ts
import { getBella, bella } from '@bella-baxter/next';

export async function GET() {
  // Option A: full config object
  const config = getBella();
  const dbUrl = config.getOrThrow('DATABASE_URL');

  // Option B: direct shorthand
  const redisUrl = bella('REDIS_URL');

  return Response.json({ ok: true });
}

Typed secrets

Run bella secrets generate typescript --declaration to generate bella-secrets.d.ts. getBella() returns BellaConfig & BellaSecrets — typed property access works automatically:

getBella().DATABASE_URL  // string — typed!

Environment variables

Links

• GitHub
• Issues
• Core SDK