Le Space Blog

Local-first, peer-to-peer blogging powered by OrbitDB, libp2p, and IPFS.

Status: alpha/experimental. Not security audited.

Try It (PWA)

Production: https://blog.le-space.de

Deployments are published from GitHub Actions to Aleph IPFS and attached to the production domain automatically.

What It Does

• Create a personal blog in the browser.
• Replicate posts, comments, and media directly between peers.
• Store media locally on IPFS (Helia).
• Share a blog address and subscribe from another peer.

Docs

• Markdown extensions: docs/MARKDOWN_GUIDE.md
• Remote Markdown imports: docs/REMOTE_MARKDOWN_IMPORT.md
• AI agent codebase map: docs/AI_AGENTS.md
• AI Manager NFR checklist (logging, crypto, bundle, external refs): docs/ai-nfr-checklist.md

External references (AI / roadmap)

• Atlas Cloud — Kling image-to-video: model API (tab), video / queue docs
• EIP-8004 (ERC-8004 agent registry) — https://eips.ethereum.org/EIPS/eip-8004
• erc-8004-example — https://github.com/vistara-apps/erc-8004-example

Development

npm i
npm run dev

Relay (local):

npm run relay:test

Tests

npm test
npm run test:e2e

Deployment

The production site is built from dist/ and deployed by .github/workflows/deploy-site.yml, which installs @le-space/node@0.1.45 and runs its Node-based Aleph site runner.

Required repository secret:

• ALEPH_PRIVATE_KEY

Optional repository variable:

• ALEPH_SITE_DOMAIN to override the default blog.le-space.de

The deploy workflow also keeps only the latest 10 Aleph site uploads for the orbit-blog-prod site scope, so older uploads from this same site wallet stream are forgotten automatically after a successful publish.

Debugging

Browser console examples:

localStorage.setItem('debug', 'le-space:blog:*')
localStorage.setItem('debug', 'le-space:blog:p2p,le-space:blog:db,le-space:blog:posts')
localStorage.setItem('debug', 'libp2p:*,helia:*,le-space:blog:*')

Local dev via env:

LOG_LEVEL=debug npm run dev

License

MIT

Contact

https://www.le-space.de