Skip to content

Centrali Documentation

Welcome to Centrali - your Backend-as-a-Service platform for building modern web applications!

What is Centrali?

Centrali provides everything you need to build web applications without managing infrastructure:

  • Data Management - Define schemas and store records with automatic validation
  • Serverless Functions - Write JavaScript that runs in the cloud
  • File Storage - Upload and manage files with CDN delivery
  • Full-Text Search - Instant search across all your data
  • Automation - Triggers and webhooks for event-driven workflows
  • Real-time Updates - WebSocket notifications for live data

Quick Start

Get started in minutes:

  1. Account Setup - Create your account and get credentials
  2. Introduction - Understand what Centrali can do
  3. Quick Start Guide - Build your first API in 10 minutes
  4. Your Workspace - Understand your Centrali environment

Core Features

Data Management

Compute & Automation

Additional Features

SDKs & Tools

Build faster with our official SDKs:

JavaScript/TypeScript SDK

Install and start building in seconds:

npm install @centrali-io/centrali-sdk

import { CentraliSDK } from '@centrali-io/centrali-sdk';

// Initialize with service account credentials
const centrali = new CentraliSDK({
  baseUrl: 'https://api.centrali.io',
  workspaceId: 'your-workspace',
  clientId: process.env.CENTRALI_CLIENT_ID,
  clientSecret: process.env.CENTRALI_CLIENT_SECRET
});

// Create records with one line
const product = await centrali.createRecord('Product', {
  name: 'Awesome Product',
  price: 99.99
});

// Invoke functions easily
const result = await centrali.invokeFunction('calculate-discount', {
  productId: product.id,
  couponCode: 'SAVE20'
});

Learn more about the JavaScript SDK →

New to Centrali? Start with the Account Setup Guide to get your service account credentials.

API Reference

Complete API documentation:

Examples & Tutorials

Learn by building real applications:

Common Use Cases

Building a SaaS Application

  1. Define user and subscription structures
  2. Implement authentication with service accounts
  3. Create compute functions for business logic
  4. Set up webhooks for payment processing

Creating a Content Management System

  1. Design content structures (posts, pages, media)
  2. Implement CRUD operations via Records API
  3. Add search functionality
  4. Build moderation workflows with functions

Mobile App Backend

  1. Set up user authentication
  2. Create data structures for app content
  3. Implement push notifications
  4. Handle file uploads for user content

Quick Code Examples

Create a Record

// First, get a token from your service account credentials
// See: https://centrali.io/docs/guides/authentication-overview

const response = await fetch('https://api.centrali.io/data/workspace/your-workspace/api/v1/records', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    structureId: 'str_products',
    data: {
      name: 'Amazing Widget',
      price: 99.99,
      inStock: true
    }
  })
});

Write a Function

exports.handler = async (event, context) => {
  const { centrali } = context.apis;

  // Process the incoming data
  const result = await centrali.records.create({
    structure: 'Orders',
    data: event.data
  });

  return {
    success: true,
    data: result
  };
};

Query Data

const query = `
  FROM Product
  WHERE price < 100 AND inStock = true
  ORDER BY createdAt DESC
  LIMIT 10
`;

const results = await centrali.query(query);

Getting Help

Ready to Build?

Start with our Quick Start Guide and build your first Centrali application today!

Documentation Version 2.0 - Focused on building applications, not infrastructure