A curated reading list for the parallel society http://heterarchy.fyi/books

Find a file

tree 8ad3ba82a8 Update dependency reference for @heterarchy-society/atlas in package.json and adjust deployment workflow to reflect the new package name.		2026-05-26 15:22:41 +02:00
.github/workflows	Update dependency reference for @heterarchy-society/atlas in package.json and adjust deployment workflow to reflect the new package name.	2026-05-26 15:22:41 +02:00
assets	Add "The Internet of Money" book	2026-05-25 12:31:27 +02:00
books	Update dependencies in package.json and bun.lock; add package-lock.json to .gitignore for improved dependency management.	2026-05-26 12:53:53 +02:00
schema	Update book metadata to include authors' details across multiple titles and modify the schema to require an array of authors, enhancing consistency and accuracy in the project.	2026-05-25 04:20:45 +02:00
.gitignore	Update dependencies in package.json and bun.lock; add package-lock.json to .gitignore for improved dependency management.	2026-05-26 12:53:53 +02:00
bun.lock	Update dependencies in package.json and bun.lock; add package-lock.json to .gitignore for improved dependency management.	2026-05-26 12:53:53 +02:00
config.toml	Update .gitignore to include 'dist' and '.atlas-cache'; add bun.lock for dependency management; modify config.toml to include image sizes; enhance deploy workflow with caching for Atlas images.	2026-05-25 08:05:28 +02:00
package.json	Update dependency reference for @heterarchy-society/atlas in package.json and adjust deployment workflow to reflect the new package name.	2026-05-26 15:22:41 +02:00
README.md	Remove 'tags' field from book metadata schema and individual book files to streamline data structure and focus on glossary terms.	2026-05-23 02:22:10 +02:00
redirects.yaml	Update package.json to specify a commit hash for @heterarchy/atlas dependency; add redirects.yaml for managing canonical IDs of book files.	2026-05-25 10:35:17 +02:00

README.md

Heterarchy Books

A curated library of books for The Heterarchy Society. Each book is a YAML file; a build script compiles them into static JSON deployed via GitHub Pages.

Browse: heterarchy.fyi/books
API / bundle: books.data.heterarchy.fyi

Adding or editing books

Each book lives in books/{id}.yaml. The filename (without .yaml) becomes the book's ID — use lowercase kebab-case (e.g. sovereign-individual.yaml). Cover images go in assets/ with the same base name.

Fields:

Field	Required	Type	Description
`title`	yes	string	Full title of the book
`author`	yes	string	Author(s)
`description`	yes	string	Short description
`language`	yes	string[]	Language codes (`en`, `cs`, `de`)
`formats`	yes	string[]	Available formats (`ebook`, `pdf`, `web`, `print`)
`physical`	yes	boolean	Available as a physical copy in the library
`links`	yes	object[]	Links to read/buy (`href` + `label` required, `external` optional)
`cover`	no	string	Cover image filename (place file in `assets/`)
`year`	no	string	Publication year
`glossary`	no	string[]	Related glossary term IDs
`source`	no	object	Where the book was sourced from (`name` + `href`)

Example:

cover: sovereign-individual.jpg
title: The Sovereign Individual
author: James Dale Davidson & William Rees-Mogg
year: "1997"
description: |
  Mastering the Transition to the Information Age.
language: [en]
formats: [ebook]
physical: false
glossary: [self-sovereignty, digital-autonomy]
links:
  - href: https://archive.org/details/the-sovereign-individual
    label: "→ číst na archive.org"
    external: true
source:
  name: Sovereign Engineering
  href: https://sovereignengineering.io/books

Development

bun install
bun run build   # generate dist/ output

Output

The build generates:

dist/index.json — all books with metadata
dist/books.js — ES module export
dist/history/{id}.json — per-book commit history with diffs
dist/changelog.json — all commits with referenced book changes

Deployment

Pushing to main triggers GitHub Actions to build and deploy dist/ to GitHub Pages. Enable Pages in your repository settings with source set to GitHub Actions.