Concepts

How Techne works

Next release: this page describes techne-sdk/types, which is not in techne-sdk 0.3.4 yet. With techne-sdk 0.3 today shows the released API.

Five layers, each with one job. Here is Maya's park passing through all five.

The record
Eben G. Fine Parkpub.techne.draft.placeAdded by maya.techne.town, in Boulder

Written to their PDS.

The person signs in with their atproto account, maya.techne.town. Your app builds the record with Place.create and techne.put writes it to their repo, not to techne.computer.

TypeScript
What it amounts to

Checked against its shape on techne.pub.

The type lives at place.draft.techne.pub. The same check runs in your app and on techne.computer.

TypeScript
What it amounts to

Indexed by techne.computer; spaces decide who reads.

techne.computer indexes each version and marks it valid, pending or invalid. A place has a public home; a private record lives in a space, whose read policy decides who reads it.

TypeScript
What it amounts to

Read with techne.query or techne.get.

A read is a query document; Place.query builds one, typed to the place's roles. Every read answers items, each with its uri and record.

TypeScript
What it amounts to

Shown in Commons and Beacon.

Commons lists the park in its directory; Beacon offers it as somewhere to meet. Both use the same hooks from techne-sdk/react.

React
What people see
Commons · Directory

Eben G. Fine Park

Park · 101 Arapahoe Ave, Boulder, CO
by maya.techne.town

Click a layer to see its code.