CR
CR Labz
v2.2.0
Updated 48h ago

Documentation Center

Explore implementation blueprints, API references and troubleshooting playbooks crafted by our engineering team. Everything here is production tested and continuously updated.

Support Center

Contact our specialists or open a ticket in under a minute.

Status Dashboard

Monitor real-time uptime, planned maintenance and incident history.

API Explorer

Try every endpoint directly in the browser with your workspace token.

Integration snapshots

Getting Started
#quick-start

Quick Start Guide

Launch your first workflow in minutes. Follow the guided path below to authenticate, configure the SDK and trigger your inaugural request.

  1. 01

    Create your workspace

    Register in the dashboard, invite your teammates and copy your workspace API key from Settings → Access tokens.

  2. 02

    Install the toolkit

    Add the CRLabz SDK or preferred integration to your project using your package manager of choice.

  3. 03

    Configure environment

    Add the CRLABZ_API_KEY variable to your environment file and select the target environment (sandbox, staging or production).

  4. 04

    Trigger your first call

    Use the `projects.create` helper or the REST endpoint to create a sample project and validate connectivity.

Workspace created and teammates invited
SDK installed and configured
Environment variables loaded
Smoke request executed successfully

Quick Start

Initialize the SDK and create your first project.

// Install the package
pnpm add @crlabz/sdk

// Initialize the SDK (commented out for deployment)
// import { CRLabzSDK } from '@crlabz/sdk'

// const sdk = new CRLabzSDK({
//   apiKey: process.env.CRLABZ_API_KEY!,
//   environment: 'production',
// })

// Make your first API call (commented out for deployment)
// const project = await sdk.projects.create({
  name: 'My Project',
  type: 'web-app',
})

React Provider

Wrap your application with the provider and start using hooks.

import { CRLabzProvider, useProjects } from '@crlabz/react-sdk'

function Projects() {
  const { data, isLoading } = useProjects()

  if (isLoading) return <span>Loading...</span>

  return (
    <ul>
      {data?.map((project) => (
        <li key={project.id}>{project.name}</li>
      ))}
    </ul>
  )
}

export function App() {
  return (
    <CRLabzProvider apiKey={process.env.NEXT_PUBLIC_CRLABZ_KEY || 'demo-key'}>
      <Projects />
    </CRLabzProvider>
  )
}
Getting Started
#installation

Installation

Install the SDKs, CLIs or language clients that match your stack. Every artifact is published with semantic versioning and signed builds.

Requires Node.js 18+, Bun 1.0+ or Deno 1.39+

Supports ESM and CommonJS consumers

Available for browser, server and edge runtimes

pnpm

pnpm add @crlabz/sdk

npm

npm install @crlabz/sdk

yarn

yarn add @crlabz/sdk
Getting Started
#configuration

Configuration

Configure authentication, retries and logging for each environment. The SDK automatically loads configuration from environment variables.

  1. 01

    Create environment files

    Set CRLABZ_API_KEY and CRLABZ_ENVIRONMENT per environment. Never commit secrets—use your platform's secrets manager.

  2. 02

    Tune retries

    Define retry strategy with exponential backoff and jitter using the sdk.client.configure method.

  3. 03

    Enable observability

    Forward logs and metrics using the built-in logger integrations for Datadog, OpenTelemetry or custom transports.

Getting Started
#first-project

First Project

Use curated templates to bootstrap new projects. Roll back instantly with preview environments tied to every branch.

  1. 01

    Select a template

    Choose from web app, data pipeline, automation workflow or bring your own stack via custom templates.

  2. 02

    Provision services

    CRLabz orchestrates storage, secrets and background workers. Track provisioning live inside the dashboard.

  3. 03

    Promote to staging

    Validate using preview URLs with automatic seed data and share with stakeholders before going live.

API Reference
#auth

Authentication

Authenticate with OAuth 2.1, API keys or signed JWTs. All requests must include TLS 1.3 with strong cipher suites.

OAuth flow with PKCE for user-level access

Service tokens with granular scopes

Automatic token rotation and revocation API

API Reference
#endpoints

Endpoints

Discover every REST and GraphQL endpoint with sample payloads, expected responses and schema diffs between versions.

REST base URL: https://api.crlabz.dev

GraphQL endpoint: https://api.crlabz.dev/graphql

Real-time webhook events for project, billing and audit changes

API Reference
#rate-limits

Rate Limits

Plan-aware limits keep the platform responsive for everyone. We provide soft warnings, adaptive scaling and transparent quota resets.

Burstable quotas with graceful throttling

Webhook notifications at 80% consumption

Custom enterprise agreements on request

Plan
Limit
Burst
Notes
Starter
120 req/min
240 req/min

Includes sandbox endpoints

Resets every minute

Growth
600 req/min
1,200 req/min

Request adaptive scaling

Resets every 30 seconds

Scale
2,500 req/min
5,000 req/min

Custom SLA available

Resets every 15 seconds

API Reference
#errors

Error Handling

Consistent error envelopes keep debugging simple. Pair them with observability hooks to surface actionable insights instantly.

Structured error codes prefixed with CRL

Machine-readable hints for quick remediation

Correlation IDs for every request and webhook

Pro tips

  • Log the `traceId` header to join platform telemetry with your logs.
  • Use the `x-crlabz-retry` header to honour safe retries.
  • Subscribe to incident webhooks to automate escalation.
Integration Guides
#react

React Integration

Ship dynamic interfaces using React hooks and server components powered by CRLabz.

First-class support for Suspense and streaming

Automatic cache invalidation via mutations

Type-safe hooks generated from your schemas

Integration Guides
#nextjs

Next.js Setup

Use CRLabz within the Next.js App Router. Deploy edge-ready APIs without extra boilerplate.

Compatible with Route Handlers and Middleware

Edge runtime support with web standard fetch

Server actions with automatic streaming updates

Integration Guides
#vue

Vue.js Integration

Compose reactive dashboards with Vue 3, Pinia and CRLabz composables.

Use `useCRLabz` composable for data fetching

Nuxt module with SSR-aware caching

Script setup compatible typings

Integration Guides
#mobile

Mobile SDKs

Offline-first mobile SDKs with delta sync and encrypted persistence.

Swift and Kotlin packages published weekly

React Native bridge with TypeScript typings

Background sync scheduler with push notifications

Best Practices
#security

Security Guidelines

Protect your workspace with defense-in-depth controls and audit trails.

Enable SSO with enforced MFA
Rotate service tokens quarterly
Restrict IP ranges for production keys
Forward audit logs to your SIEM
Best Practices
#performance

Performance Tips

Unlock millisecond responses with caching, batching and streaming primitives.

Leverage query batching to reduce network hops

Enable CDN caching for public project assets

Use background jobs for heavy computations

Best Practices
#standards

Code Standards

Adopt conventions that keep teams productive and codebases consistent.

Follow the CRLabz lint rules for TypeScript
Document endpoints with OpenAPI annotations
Automate schema validation in CI
Use preview deployments for every pull request
Best Practices
#testing

Testing

Test everything from unit logic to end-to-end workflows with production-like fixtures.

Mock CRLabz responses using our official MSW handlers

Spin up ephemeral sandboxes in CI via the CLI

Leverage contract testing for mission critical APIs

Troubleshooting
#common-issues

Common Issues

Resolve the most reported issues in minutes using curated playbooks.

401 Unauthorized — verify scopes and rotate tokens

429 Too Many Requests — inspect rate-limit headers

Webhook signature mismatch — resync signing secret

Troubleshooting
#debugging

Debugging

Trace requests across services and triage incidents with precision.

  1. 01

    Capture correlation IDs

    Every response includes an `x-crlabz-trace` header. Log it to stitch platform telemetry with your system.

  2. 02

    Replay in the explorer

    Paste the trace ID into the API explorer to replay the failing request with redacted secrets.

  3. 03

    Escalate with context

    Attach HAR files, logs and screenshots when contacting support to jump to the resolution stage.

Troubleshooting
#support

Support

Our specialists respond 24/7 for production incidents. Browse playbooks, open tickets or join office hours.

Pro tips

  • Enable PagerDuty or Opsgenie integrations for automatic routing.
  • Set up webhook alerts for SLA thresholds.
Troubleshooting
#community

Community

Connect with thousands of builders shipping with CRLabz. Share knowledge, attend livestreams and access private betas.

Weekly live build sessions

Design partners program for roadmap influence

Community forum with staff moderation

Join the community

Share learnings, request features and collaborate with other builders. Our team hosts weekly livestreams and office hours.