OFFICIAL PACKAGES

First-Party Client Libraries

Official client libraries and developer tooling maintained directly by the urBackend core team.

TYPESCRIPT & JAVASCRIPT v0.4.8

@urbackend/sdk

Framework-agnostic core SDK. Provides typed collections, auth session caching, RLS headers, file uploads, and mail dispatchers.

npm install @urbackend/sdk

import urBackend from '@urbackend/sdk';

const client = urBackend({ 
  apiKey: 'pk_live_your_key' 
});

// Query database with MongoDB operators
const posts = await client.db.getAll('posts', {
  filter: { published: true },
  sort: 'createdAt:desc',
  limit: 10
});

REACT & NEXT.JS v0.2.7

@urbackend/react

First-class React support with <UrProvider />, authentication drop-in UI (<UrAuth />), protected route guards, and custom hooks.

npm install @urbackend/react @urbackend/sdk

import { UrProvider, UrAuth, useUser, useDb } from '@urbackend/react';

function App() {
  return (
    <UrProvider apiKey="pk_live_your_key">
      <Dashboard />
    </UrProvider>
  );
}

function Dashboard() {
  const { user, logout } = useUser();
  const db = useDb();
  // ...
}

PYTHON & FASTAPI v0.1.1

urbackend (Python)

Python SDK built on requests. Seamless integration for Django, Flask, FastAPI microservices, and AI pipelines.

pip install urbackend

from urbackend import UrBackendClient

client = UrBackendClient(api_key="pk_live_your_key")

# CRUD operations
post = client.db.insert(
    "posts",
    {"title": "Hello from Python", "published": True},
    token=client.auth.get_token()
)

TERMINAL TOOL v0.2.0

@urbackend/cli

Manage projects from your command line. Sync collections, pull schemas, and generate strict TypeScript definition files.

npm install -g @urbackend/cli

# Login with Personal Access Token (PAT)
ub login

# Link workspace to urBackend project
ub init

# Pull remote schemas & generate urbackend.d.ts
ub pull
ub generate

DEVELOPER EXPERIENCE

Engineered for Developer Joy

We obsess over developer ergonomics so you spend time building features instead of managing plumbing.

Strict Type Generation

Run ub generate from the CLI to generate complete TypeScript definitions matching your live MongoDB collection schemas.

Publishable vs Secret Keys

Public keys (pk_live) are safe for frontend bundles and enforced by RLS. Secret keys (sk_live) unlock full administrative access.

Low Latency Global Gateway

Optimized connection pooling, Redis LRU cache, and lightweight Express gateways with sub-50ms average responses.

Open REST Specification

Every urBackend project outputs predictable REST endpoints. If you do not want an SDK, query directly with fetch or cURL.

Built by developers, for modern Builders