Real-time State Management

BigState

A powerful real-time state management platform that enables seamless data synchronization between your services and clients. Build live dashboards, collaborative tools, IoT systems, and gaming applications with ease.

Get Started Documentation

Why BigState?

Everything you need to build real-time applications without the complexity

⚡

Real-Time by Default

Instant state propagation via WebSocket. No polling, no delays — just immediate updates across all connected clients.

🔌

Simple Integration

Clean SDK for JavaScript, React, and Node.js. Get started in minutes with our intuitive API.

🛡️

Secure & Controlled

Fine-grained access control with Principals and Policies. Define exactly who can read or write each piece of state.

📈

Built for Scale

Designed to handle millions of state updates. Perfect for applications that need to grow.

How It Works

Three simple steps to real-time data synchronization

Publish

Your backend, IoT devices, or services push state updates via HTTP using our simple API.

await client.stateSet(sid, { value: data });

Route

BigState stores the state and routes updates through your configured Delivery channels.

// Automatic routing via Delivery

Frontends and clients receive real-time updates instantly via WebSocket connection.

wsClient.subscribeStateUpdate(deliveryIds, callback);

Core Concepts

BigState is built around five key concepts

Subject

An entity with mutable state. Represents logical objects your application can track, update, and query — like user locations, sensor readings, or game scores.

State

The current value of a Subject, timestamped and versioned. Fully flexible data that can represent any kind of information for your use case.

Delivery

A channel that routes state updates to subscribers via WebSocket. Configure how and where your state updates are delivered.

Principal

An identity (user, device, service) that interacts with the system. Organize subjects and control access across related components.

Policy

Access control rules defining what actions Principals can perform. Specify which principals can perform which actions on which resources.

Ready to learn more?

Read the Docs

Simple & Powerful API

Get started with just a few lines of code

example.js

import { BigStateHttpClient, BigStateWsDeliveryClient } from 'bigstate.client.javascript';

	// Initialize clients
	const client = new BigStateHttpClient({
		baseUrl: 'https://api.bigstate.dev',
		apiKey: 'YOUR_API_KEY'
	});
	
	const wsClient = new BigStateWsDeliveryClient({
		baseUrl: 'wss://ws.bigstate.dev',
		apiKey: 'YOUR_API_KEY'
	});

example.js


	// Create a subject
	await client.subjectCreate({
		name: 'User Location',
		desc: 'Real-time user geolocation',
		type: 2
	}, 'user:location');
	
	// Publish state
	await client.stateSet('user:location', {
		at: new Date().toISOString(),
		value: { lat: 40.7128, lng: -74.0060 }
	});

example.js


		// Subscribe to real-time updates
		wsClient.subscribeStateUpdate(['my-delivery'], (message) => {
			console.log('New state:', message.value);
		});

Built for Any Use Case

From simple dashboards to complex distributed systems

📊

Live Dashboards

Real-time analytics, monitoring panels, and data visualization that updates instantly.

💬

Chat & Collaboration

Build chat applications, collaborative editors, and real-time document sharing.

🎮

Gaming

Multiplayer game state, leaderboards, and real-time player synchronization.

📡

IoT Systems

Sensor data streaming, device monitoring, and smart home automation.

💹

Financial Data

Stock prices, cryptocurrency rates, and real-time trading updates.

🚚

Logistics & Tracking

Fleet management, delivery tracking, and real-time location updates.

Ready to Build Real-Time Apps?

Start building with BigState today. Our comprehensive documentation and tutorials will help you get up and running in minutes.

Start Building

View Tutorial