Human Share

Humans

Public states for people — reports, files, and live views.

Curate complex data once and make it available to readers, dashboards, and services. The same foundation as Applications and AI — versioned state, policies, and live delivery.

Create API KeyHumans docs

What You Can Publish

Share reports, files, and updates that people can open and trust as current

📄

Reports & Documents

Share the latest report or metrics snapshot. People and apps always see the current version — no emailing files around.

🖼️

Files & Images

Upload PDFs, photos, and other files once. Everyone who has access gets the newest copy automatically.

🔄

Always the Latest

People stop opening yesterday's file. When you update the content, everyone sees the current version.

👥

Reach Your Audience

Colleagues, partners, or the public — share curated data with people the same way apps already consume it.

How It Works

From curated content to readers in three steps

1

Curate

Define an object for the resource people will see — a report, gallery item, or shared document.

await httpClient.objectCreate(REPORT_OBJECT, { type: 2, ... });
2

Publish

Set state with an inline value or a valueRef after uploading large or binary content.

await httpClient.stateSet(REPORT_OBJECT, { value: data });
3

Share

Grant access through policies and deliver updates over WebSocket — or let clients fetch the latest snapshot.

// Policy + delivery for readers

Publish in a Few Lines

Inline state or valueRef for files and images

example.js
import { BigStateHttpClient } from 'bigstate.client.javascript';

const httpClient = new BigStateHttpClient({
	baseUrl: 'https://api.bigstate.dev',
	apiKey: 'YOUR_API_KEY',
});

const OWNER = 'YOUR_OWNER';
const REPORT_OBJECT = `report:q1@${OWNER}`;
example.js
await httpClient.objectCreate(REPORT_OBJECT, {
	type: 2,
	ttl: 100000,
	validity: 3600,
	versionDeep: null,
	info: {
		name: 'Q1 Public Report',
		desc: 'Shared metrics for dashboards and readers',
	},
});

await httpClient.stateSet(REPORT_OBJECT, {
	at: new Date().toISOString(),
	value: {
		title: 'Q1 Summary',
		revenue: 1280000,
		highlights: ['New regions', 'Lower latency'],
	},
});
example.js
// Large files: upload first, then attach valueRef
const { valueRef } = await httpClient.valueUpload(fileBytes, {
	contentType: 'application/pdf',
});

await httpClient.stateSet(REPORT_OBJECT, {
	at: new Date().toISOString(),
	valueRef,
});

Built for Human-Facing Data

One public state, many audiences

📑

Public Reports

Publish versioned reports and metrics snapshots that dashboards, partners, and AI agents can all read from one source.

🖼️

Shared Media

Distribute images, documents, and digital assets as state — update once and every reader sees the latest version.

🖥️

Human-Facing Dashboards

Build live multi-widget UIs on public streams so people watch the same data applications already produce.

🤝

Cross-Audience Sharing

One curated state feeds applications, people, and AI — no separate export pipelines for each consumer.

Ready to Share Public States?

Follow the live dashboard tutorial or dig into the State API — publish once and let people, apps, and AI read the latest version.