README
¶
Effortless self-hosted cloud with peer-to-peer sync
Open it in your browser: no account, no server, working offline in one click.
Spacewave runs in your browser with no servers: a private, encrypted workspace running entirely on your own machine: no account, no setup, no server to run. Syncs peer-to-peer between your devices and works offline.
As your work grows, the workspace becomes a Space: shared encrypted state for files, notes, apps, layouts, devices, and workflows. Spaces are multiplayer: invite people into one and work in it together, live.
You choose where your data lives and how it moves. Store it on your machines, in your browser, on your own server, or in a cloud you pick, and sync over any network your devices can reach. A paid account adds managed cloud storage and relay, $8/month for 100 GB; the app works without one, and the cloud never owns your work.
Make it your own with the same machinery the app is made of: a Go, TypeScript, React, and WebAssembly stack where every app is local-first, multiplayer, and encrypted by default.
Features:
- Spaces: One shared place for your files, notes, apps, devices, and workflows
- Multiplayer: Invite people into a Space and work in it together, live
- Peer-to-Peer Sync: Sync directly between your devices and keep working offline
- Any Network: Connect over WebRTC, WebSocket, LAN, or relay - whatever your devices can reach
- Pluggable Storage: Keep data on your machines, in your browser, or in any backend you choose
- End-to-End Encrypted: Storage, sync, and collaboration are private by default
- Open-Source Full Stack: Build your own apps and plugins with Go, TypeScript, React, and WebAssembly
Plugin Ecosystem: Extend a Space with plugins:
- Files, databases, notes, and document collaboration
- Chat and messaging
- Terminal access and remote control of your devices
- SkiffOS for building and managing Linux devices
Getting Started
Where would you like to start?
- I want to use or self-host Spacewave: Open Spacewave to get started!
- I want to modify Spacewave or build my own plugins: see running from source
- I want to develop my own app with Spacewave Stack: see Bldr
You can try Spacewave instantly in your web browser, just click here.
Running from source
To start the Spacewave app:
# Install dependencies
bun install
uv sync --frozen --all-groups
# Start the desktop app
bun run start:desktop
# Start the web app with GoScript browser Go plugins
bun run start:web
# Start the web app with standard Go/WASM browser Go plugins
bun run start:web:wasm
To run the test suite:
# All tests
bun run test
# Go tests only
bun run test:go
# Lint
bun run lint
# Typecheck
bun run typecheck
Spacewave uses Protobuf for message encoding.
You should re-generate the protobufs after changing any .proto file:
# generate the protobufs
bun run gen
Why Spacewave?
Traditional web-apps store and process data on servers and cloud infrastructure. Developers write API calls to access the user data, and the frontend just displays the response. Recent trends towards server-side rendering have increased dependence on servers and the cloud even more.
This works great for static websites and services that require an internet connection. But what if we want apps that work offline, are open-source, or use features traditionally expensive to scale like multiplayer sync?
Imagine if every video game you played was rendered fully server-side. That game would be way too laggy to play smoothly, right? This is how our modern web apps are designed and built. But it doesn't have to be this way.
Modern web browsers come with WebAssembly, WebWorkers, ServiceWorkers, SharedWorkers, IndexedDB, and WebRTC. These features enable building fully self-sufficient apps running fully on the client side.
Spacewave utilizes these features to provide resources to apps with an abstraction layer smoothing the differences between platforms. For example, an app can allocate a SQL database and store it in Redis, s4db, or IndexedDB, all without changing a single line of code when switching backends.
We look forward to building a new generation of apps that are both open-source and cloud-enabled, without requiring users to jump through hoops to self-host and manage their own servers.
Architecture
The goal is to build software that runs anywhere with any storage backend.
Spacewave runs the app logic in WebWorkers/SharedWorkers in the web browser and as native processes on desktop. This brings the entire Go ecosystem to the browser while enabling true local-first apps.
Components:
-
Bifrost - Network over any transport
- Cross-platform peer-to-peer communication
- Encrypted transport protocols with stream multiplexing
- Supports WebRTC and WebSocket in the web browser
-
Hydra - Store data anywhere w/ p2p sync
- Many supported data structures: SQL, K/V, GraphDB, ...
- Pluggable storage backends: s4db, Redis, S3, ...
- Supports IndexedDB in the web browser
-
Bldr - Build and run on any OS or browser
-
GoScript - Compile Go to TypeScript for the web browser
- Builds Go module packages into readable TypeScript modules
- Shares Go algorithms, data structures, and runtime code without a second implementation
- Powers Bldr's Go compiler mode for Spacewave web plugins and browser builds
-
SkiffOS - Build and run on any device (w/ Linux)
- Supports 40+ device types
- Cross-compiles to target any architecture
- Minimal with modular configuration
-
Forge - Continuous integration and automation
- Distributed job scheduler
- CI/CD pipeline automation
- Workflow orchestration
-
Auth - Authentication methods and credential flows
- Password and PEM-based authentication primitives
- Shared auth building blocks for provider and session flows
-
Identity - Identity and domain primitives
- Identity records and domain-backed configuration
- Supporting types for account and provider workflows
All components are designed to be used in multiple ways:
- As an application: each component has its own CLI
- As a library: all Go packages are documented as libraries
- As part of Spacewave: controller configuration with YAML/JSON
Spacewave can be extended with custom plugins or modifications to the client, and custom apps can use the libraries to directly access the data stored in your workspaces.
The current repository is a monorepo. The root app layer sits alongside the component directories:
net/- Bifrostdb/- Hydrabldr/- Bldrforge/- Forgeauth/- Authidentity/- Identityapp/,core/,sdk/,web/,cmd/- the Spacewave application layer
Space: The Final Frontier
Let's take a moment to look far into the future. We're sending the first people to Mars. What OS are they using on their laptops and phones? What apps are they using to share files, collaborate, and communicate?
The latency of a one-way message from Mars to Earth varies between 2 to 24 minutes. HTTPs does not work with this much latency, and even begins to break with round-trip times over one second, let alone two minutes. Our existing internet apps would not work in this environment.
Spacewave solves this problem with a local-first p2p architecture. Regardless of internet latency or equipment failure, users can access their workspaces and apps, without the need for cloud, servers, or on-call engineers.
Peer-to-peer networking works even when the internet doesn't.
License
Spacewave is licensed under the permissive Apache-2.0 license.
All dependencies are verified to be equally permissive, one of:
- 0BSD
- Apache-2.0
- Apache-2.0 OR MIT
- BSD-2-Clause
- BSD-3-Clause
- CC0-1.0
- ISC
- MIT
- MPL-2.0
All of these licenses support commercial use, modification, and redistribution with attribution.
Support and Community
Spacewave is a community project to build the most powerful collaborative workspace and self-hosting tool.
We welcome contributions in the form of GitHub issues and pull requests.
Please open a GitHub issue with any questions / issues / suggestions.
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
View Source
var DistSources embed.FS
DistSources contains the TypeScript source closure that downstream apps use to resolve Spacewave package imports without a sibling checkout.
View Source
var MetaSources embed.FS
MetaSources contains docs, license files, etc.
Functions ¶
func BuildMetaSourcesFSCursor ¶
func BuildMetaSourcesFSCursor() *unixfs_iofs.FSCursor
BuildMetaSourcesFSCursor builds a *fs.Cursor for the MetaSources.
func BuildMetaSourcesFSHandle ¶
BuildMetaSourcesFSHandle builds a unixfs FSHandle for the MetaSources.
Types ¶
This section is empty.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
examples/authtester
command
|
|
|
examples/logintester
command
|
|
|
method/password
Package auth_method_password implements password-based entity key derivation using scrypt with a blake3-derived deterministic salt from the username.
|
Package auth_method_password implements password-based entity key derivation using scrypt with a blake3-derived deterministic salt from the username. |
|
method/pem
Package auth_method_pem implements a PEM backup key auth method.
|
Package auth_method_pem implements a PEM backup key auth method. |
|
cmd/bldr
command
|
|
|
devtool/callpath
Package callpath finds static call paths between Go functions.
|
Package callpath finds static call paths between Go functions. |
|
devtool/trace/parser/raw
Package raw provides an interface to interpret and emit Go execution traces.
|
Package raw provides an interface to interpret and emit Go execution traces. |
|
devtool/trace/parser/tracev2
Package tracev2 contains definitions for the v2 execution trace wire format.
|
Package tracev2 contains definitions for the v2 execution trace wire format. |
|
devtool/web/entrypoint
command
|
|
|
distpath
Package distpath resolves Bldr dist source paths.
|
Package distpath resolves Bldr dist source paths. |
|
entrypoint/compose
Package compose carries the project-supplied part of a host process.
|
Package compose carries the project-supplied part of a host process. |
|
entrypoint/fatal
Package fatal carries process-fatal boot conditions from bus controllers to the entrypoint command that owns the process exit.
|
Package fatal carries process-fatal boot conditions from bus controllers to the entrypoint command that owns the process exit. |
|
entrypoint/state
Package state defines the durable state shared by native entrypoints.
|
Package state defines the durable state shared by native entrypoints. |
|
example/cli
Package example_cli provides example CLI commands for the bldr demo.
|
Package example_cli provides example CLI commands for the bldr demo. |
|
exp/autobun/main
command
|
|
|
plugin/compiler/esbuild
Package esbuild builds JavaScript plugins from a source filesystem and integrity-pinned npm tarballs, without a package manager or disk checkout.
|
Package esbuild builds JavaScript plugins from a source filesystem and integrity-pinned npm tarballs, without a package manager or disk checkout. |
|
plugin/compiler/go/dev-wrapper
command
|
|
|
plugin/host/logs
Package plugin_host_logs contains structured plugin log schema types.
|
Package plugin_host_logs contains structured plugin log schema types. |
|
plugin/host/mock
Package plugin_host_mock provides plugin host test doubles.
|
Package plugin_host_mock provides plugin host test doubles. |
|
plugin/host/static
Package plugin_host_static resolves LookupPluginHost with a fixed set of plugin hosts that another component runs.
|
Package plugin_host_static resolves LookupPluginHost with a fixed set of plugin hosts that another component runs. |
|
plugin/host/wazero-quickjs/gen
command
|
|
|
project/bunlock
Package bunlock reads integrity-pinned npm dependencies from bun.lock and stores verified tarballs in a caller's block-backed dependency tree.
|
Package bunlock reads integrity-pinned npm dependencies from bun.lock and stores verified tarballs in a caller's block-backed dependency tree. |
|
prototypes/build-web-pkg
command
|
|
|
prototypes/detect-parent-exit
command
|
|
|
prototypes/go-js-async-iterable
command
|
|
|
prototypes/go-js-packet-stream
command
|
|
|
prototypes/http-reader-at
command
|
|
|
prototypes/js-wazero-quickjs
command
|
|
|
prototypes/sync-optimization
command
test-gomod-compare: Tests whether comparing the generated go.mod with the existing file on disk can be used to skip go mod tidy + vendor.
|
test-gomod-compare: Tests whether comparing the generated go.mod with the existing file on disk can be used to skip go mod tidy + vendor. |
|
prototypes/wasi
command
|
|
|
prototypes/wasi/run-wazero-go
command
|
|
|
resource/proxy
Package resource_proxy serves a client's Resource SDK from a resource tree of its own, mapped onto an upstream tree whose connection can be replaced.
|
Package resource_proxy serves a client's Resource SDK from a resource tree of its own, mapped onto an upstream tree whose connection can be replaced. |
|
statepath
Package statepath owns cleanup policy for Bldr state roots.
|
Package statepath owns cleanup policy for Bldr state roots. |
|
storage/node
Package storage_node binds Node SQLite connections to the existing volume factory.
|
Package storage_node binds Node SQLite connections to the existing volume factory. |
|
util/buildbudget
Package bldr_buildbudget bounds concurrent memory-heavy Bldr build stages.
|
Package bldr_buildbudget bounds concurrent memory-heavy Bldr build stages. |
|
util/buildcache
Package bldr_util_buildcache stores the outputs of deterministic build steps, keyed by the step's request and validated by the content of every file the step read, so a rebuild that reads the same content replays the outputs instead of running the step.
|
Package bldr_util_buildcache stores the outputs of deterministic build steps, keyed by the step's request and validated by the content of every file the step read, so a rebuild that reads the same content replays the outputs instead of running the step. |
|
util/hostmem
Package hostmem reports the physical memory of the host.
|
Package hostmem reports the physical memory of the host. |
|
util/logfile
Package logfile provides file-based logging for bldr via logrus hooks.
|
Package logfile provides file-based logging for bldr via logrus hooks. |
|
util/logline
Package logline provides an io.Writer that logs each line a child process writes at the logrus level the line names.
|
Package logline provides an io.Writer that logs each line a child process writes at the logrus level the line names. |
|
util/qjsbytecode
Package bldr_util_qjsbytecode caches ES modules compiled to bytecode by the QuickJS-NG WASI reactor, so a later QuickJS instance links a module without parsing its source.
|
Package bldr_util_qjsbytecode caches ES modules compiled to bytecode by the QuickJS-NG WASI reactor, so a later QuickJS instance links a module without parsing its source. |
|
util/tailwriter
Package tailwriter provides an io.Writer that forwards all writes to an inner writer while keeping the last N complete lines in a ring buffer.
|
Package tailwriter provides an io.Writer that forwards all writes to an inner writer while keeping the last N complete lines in a ring buffer. |
|
util/wazerofs
Package wazerofs provides a simplified filesystem adapter that bridges UnixFS with the Wazero WebAssembly runtime's filesystem interface.
|
Package wazerofs provides a simplified filesystem adapter that bridges UnixFS with the Wazero WebAssembly runtime's filesystem interface. |
|
values
Package bldr_values contains value types that are injected to the target binary.
|
Package bldr_values contains value types that are injected to the target binary. |
|
web/entrypoint/startuptrace
Package startuptrace installs the opt-in browser runtime startup trace.
|
Package startuptrace installs the opt-in browser runtime startup trace. |
|
web/runtime/http
Package web_runtime_http serves the Bldr /b/ routes from a bus.
|
Package web_runtime_http serves the Bldr /b/ routes from a bus. |
|
cmd
|
|
|
changelog-gen
command
|
|
|
changelog-notes
command
|
|
|
entrypoint-handoff
command
|
|
|
internal/releaseconfig
Package releaseconfig applies the release-owned public settings to native producers.
|
Package releaseconfig applies the release-owned public settings to native producers. |
|
plugin-release
command
|
|
|
release-config
command
|
|
|
spacewave
command
|
|
|
spacewave-debug
command
|
|
|
spacewave-dev
command
|
|
|
spacewave-store-bench
command
|
|
|
spacewave/cli
Package spacewave_cli provides CLI commands for the spacewave CLI binary.
|
Package spacewave_cli provides CLI commands for the spacewave CLI binary. |
|
spacewave/compose
Package spacewave_compose composes the Spacewave host process for the generated CLI and distribution entrypoints.
|
Package spacewave_compose composes the Spacewave host process for the generated CLI and distribution entrypoints. |
|
core
|
|
|
alarm/watch
Package core_alarm_watch runs Alarm watches: each keeps one Alarm in step with a PureFunction's view of PromQL queries and World objects.
|
Package core_alarm_watch runs Alarm watches: each keeps one Alarm in step with a PureFunction's view of PromQL queries and World objects. |
|
daemon
Package daemon connects native Spacewave clients to the shared daemon.
|
Package daemon connects native Spacewave clients to the shared daemon. |
|
debug/trace
Package debug_trace serves Go runtime trace and pprof data via HTTP.
|
Package debug_trace serves Go runtime trace and pprof data via HTTP. |
|
device/flowgraph
Package device_flowgraph runs the Flowgraph nodes placed on this Device.
|
Package device_flowgraph runs the Flowgraph nodes placed on this Device. |
|
device/policy
Package device_policy stores and watches daemon-local Device policy.
|
Package device_policy stores and watches daemon-local Device policy. |
|
forge/dashboard
Package forge_dashboard implements the ForgeDashboard block type and world operations.
|
Package forge_dashboard implements the ForgeDashboard block type and world operations. |
|
git/lfs
Package git_lfs implements a git-lfs standalone custom transfer agent that stores Git LFS objects in a Store.
|
Package git_lfs implements a git-lfs standalone custom transfer agent that stores Git LFS objects in a Store. |
|
git/opids
Package opids declares Git operation identifiers without implementation dependencies.
|
Package opids declares Git operation identifiers without implementation dependencies. |
|
git/remote
Package git_remote implements a Git remote helper that stores refs and objects in a Space's Git Repo object.
|
Package git_remote implements a Git remote helper that stores refs and objects in a Space's Git Repo object. |
|
launcher/install
Package launcher_install installs the desktop launcher for the current user.
|
Package launcher_install installs the desktop launcher for the current user. |
|
metrics
Package metrics gathers the metrics of the running Spacewave process.
|
Package metrics gathers the metrics of the running Spacewave process. |
|
plugin/process
Package process_binding provides CRUD helpers for process bindings in the platform-account ObjectStore.
|
Package process_binding provides CRUD helpers for process bindings in the platform-account ObjectStore. |
|
plugin/webview
Package plugin_webview provides conventions for plugin ObjectType web viewer registration.
|
Package plugin_webview provides conventions for plugin ObjectType web viewer registration. |
|
provider/gccleanup
Package provider_gccleanup runs provider account GC cleanup sweeps.
|
Package provider_gccleanup runs provider account GC cleanup sweeps. |
|
provider/migration
Package provider_migration composes authorized account resource movement.
|
Package provider_migration composes authorized account resource movement. |
|
provider/spacewave/cacheseed
Package provider_spacewave_cacheseed provides the dev-only cache-seed inspector RPC service.
|
Package provider_spacewave_cacheseed provides the dev-only cache-seed inspector RPC service. |
|
provider/spacewave/cacheseedbuffer
Package cacheseedbuffer records bounded seed-reason-tagged HTTP requests.
|
Package cacheseedbuffer records bounded seed-reason-tagged HTTP requests. |
|
provider/spacewave/packfile/delta
Package delta builds incremental packfile uploads from a writable block store by diffing against a CDN mirror view and chunking the delta into size-bounded kvfile packs.
|
Package delta builds incremental packfile uploads from a writable block store by diffing against a CDN mirror view and chunking the delta into size-bounded kvfile packs. |
|
provider/spacewave/seedreason
Package seedreason owns the HTTP seed-reason taxonomy used to classify provider cloud requests.
|
Package seedreason owns the HTTP seed-reason taxonomy used to classify provider cloud requests. |
|
resource/flowgraph/registry
Package resource_flowgraph_registry resolves plugin node types through Resource capabilities.
|
Package resource_flowgraph_registry resolves plugin node types through Resource capabilities. |
|
resource/listener/control
Package control implements the local daemon control protocol that backs spacewave stop and socket takeover between the CLI daemon and the desktop app's resource listener.
|
Package control implements the local daemon control protocol that backs spacewave stop and socket takeover between the CLI daemon and the desktop app's resource listener. |
|
resource/listener/yieldpolicy
Package yieldpolicy implements the yield-policy broker used by the desktop resource listener.
|
Package yieldpolicy implements the yield-policy broker used by the desktop resource listener. |
|
session/lock
Package session_lock provides shared lock/unlock operations for session private keys.
|
Package session_lock provides shared lock/unlock operations for session private keys. |
|
sobject/replica/controller
Package sobject_replica_controller runs replica nodes: each keeps one SharedObject on its Device in step with the pair's ReplicaSpec, talking to the other node of the pair on their peer stream.
|
Package sobject_replica_controller runs replica nodes: each keeps one SharedObject on its Device in step with the pair's ReplicaSpec, talking to the other node of the pair on their peer stream. |
|
space/http/download
Package download serves projected space file content via HTTP.
|
Package download serves projected space file content via HTTP. |
|
space/http/export
Package export serves projected space data via HTTP zip routes.
|
Package export serves projected space data via HTTP zip routes. |
|
space/http/header
Package header provides shared HTTP header helpers for space HTTP handlers.
|
Package header provides shared HTTP header helpers for space HTTP handlers. |
|
space/resolve
Package resolve provides utilities for resolving resource paths to world engines.
|
Package resolve provides utilities for resolving resource paths to world engines. |
|
sync
Package sync hosts a standalone World engine over caller-selected storage.
|
Package sync hosts a standalone World engine over caller-selected storage. |
|
db
|
|
|
background
Package background runs low-priority download jobs that yield to the work a person is waiting for.
|
Package background runs low-priority download jobs that yield to the work a person is waiting for. |
|
block
Package block defines a common pattern for interacting with block reference structures in Hydra and in memory.
|
Package block defines a common pattern for interacting with block reference structures in Hydra and in memory. |
|
block/gc
Package block_gc implements garbage collection for Hydra block stores.
|
Package block_gc implements garbage collection for Hydra block stores. |
|
block/store/writeback
Package block_store_writeback keeps every block write in a local store and uploads it to a remote store in the background.
|
Package block_store_writeback keeps every block write in a local store and uploads it to a remote store in the background. |
|
cdc/jc
Package jc implements the JC (Jump Condition) content-defined chunking algorithm.
|
Package jc implements the JC (Jump Condition) content-defined chunking algorithm. |
|
cmd/hydra
command
|
|
|
coord/s4db
Package s4db coordinates the writers of a Volume stored in one s4db file through the file itself.
|
Package s4db coordinates the writers of a Volume stored in one s4db file through the file itself. |
|
core/storage
Package storage registers database factories without network controllers.
|
Package storage registers database factories without network controllers. |
|
dex/session
Package dex_session provides shared block transfer session logic for DEX backends.
|
Package dex_session provides shared block transfer session logic for DEX backends. |
|
examples/cross-platform
command
|
|
|
examples/mysql-go-orm
command
|
|
|
examples/unixfs/checkout
command
|
|
|
git/unixfs
Package unixfs_git implements a git-backed FSCursor.
|
Package unixfs_git implements a git-backed FSCursor. |
|
kvtx/block/iavl
Package iavl implements a iavl tree.
|
Package iavl implements a iavl tree. |
|
kvtx/deferred
Package kvtx_deferred holds writes to a transaction in memory and applies them as one write batch.
|
Package kvtx_deferred holds writes to a transaction in memory and applies them as one write batch. |
|
kvtx/hidalgo
Package hidalgo implements the high-level database abstractions for Go interfaces for kvtx.
|
Package hidalgo implements the high-level database abstractions for Go interfaces for kvtx. |
|
kvtx/kvfile
Package kvtx_kvfile implements a key/value store backed by a file.
|
Package kvtx_kvfile implements a key/value store backed by a file. |
|
kvtx/kvtest
Package kvtx_kvtest contains shared transaction behavior tests and fixtures.
|
Package kvtx_kvtest contains shared transaction behavior tests and fixtures. |
|
opfs/chrometest/testprog
command
|
|
|
packfile/order
Package order groups related blocks for physical packfile locality.
|
Package order groups related blocks for physical packfile locality. |
|
prototypes/billy-symlink
command
|
|
|
prototypes/block-store-volume
command
|
|
|
s4db
Package s4db is a single-file embedded key-value engine.
|
Package s4db is a single-file embedded key-value engine. |
|
sql
NewSqlDb wraps a SqlStore in a stdlib *sql.DB handle.
|
NewSqlDb wraps a SqlStore in a stdlib *sql.DB handle. |
|
sql/mock
Package sql_mock exercises a SqlStore through the stdlib high-level *sql.DB API (sql.Tx, sql.Rows.Scan), which pulls reflect via convert.go.
|
Package sql_mock exercises a SqlStore through the stdlib high-level *sql.DB API (sql.Tx, sql.Rows.Scan), which pulls reflect via convert.go. |
|
sql/mysql/devserver
Package mysql_devserver serves an in-memory Spacewave SQL database over the MySQL wire protocol, so a build-time tool that types queries by preparing them, such as Reylo, asks the same engine a Space's sql/db objects run on.
|
Package mysql_devserver serves an in-memory Spacewave SQL database over the MySQL wire protocol, so a build-time tool that types queries by preparing them, such as Reylo, asks the same engine a Space's sql/db objects run on. |
|
sql/mysql/gormadapter
Package gormadapter bridges a Mysql transaction to a gorm instance.
|
Package gormadapter bridges a Mysql transaction to a gorm instance. |
|
sql/sqlite-rpc
Package sqlite_rpc connects database/sql to an instance-bound SQLite bridge.
|
Package sqlite_rpc connects database/sql to an instance-bound SQLite bridge. |
|
store/kvkey
Package store_kvkey provides common key patterns for key/value stores.
|
Package store_kvkey provides common key patterns for key/value stores. |
|
store/kvtx/sqlite/common
Package common provides shared implementations for SQLite kvtx stores.
|
Package common provides shared implementations for SQLite kvtx stores. |
|
traceutil
Package traceutil wraps runtime/trace so callers compile under TinyGo, which lacks the runtime/trace package; the TinyGo build provides no-op equivalents.
|
Package traceutil wraps runtime/trace so callers compile under TinyGo, which lacks the runtime/trace package; the TinyGo build provides no-op equivalents. |
|
traceutil/startup
Package startuptrace provides compile-time gated startup attribution tracing.
|
Package startuptrace provides compile-time gated startup attribution tracing. |
|
unixfs/errors
Package unixfs_errors contains common error definitions.
|
Package unixfs_errors contains common error definitions. |
|
unixfs/plan9fs
Package plan9fs implements a 9p2000.L filesystem server binding to hydra's FSCursor/FSHandle interfaces.
|
Package plan9fs implements a 9p2000.L filesystem server binding to hydra's FSCursor/FSHandle interfaces. |
|
unixfs/tar
Package unixfs_tar implements a read-only FSCursor backed by a tar archive.
|
Package unixfs_tar implements a read-only FSCursor backed by a tar archive. |
|
volume/crashtest
Package crashtest checks that a volume engine recovers from a crash at any point of a randomized workload to a state its commits allow.
|
Package crashtest checks that a volume engine recovers from a crash at any point of a randomized workload to a state its commits allow. |
|
volume/device
Package device defines the storage device a browser volume engine writes through, with memory and file implementations.
|
Package device defines the storage device a browser volume engine writes through, with memory and file implementations. |
|
volume/device/devicetest
Package devicetest checks a device.Device against its contract, so native tests and browser fixtures run the same checks on every implementation.
|
Package devicetest checks a device.Device against its contract, so native tests and browser fixtures run the same checks on every implementation. |
|
volume/device/opfs
Package device_opfs implements device.Device on an OPFS directory with sync access handles, which only a dedicated worker can open.
|
Package device_opfs implements device.Device on an OPFS directory with sync access handles, which only a dedicated worker can open. |
|
volume/direct
Package direct is a volume engine that stores every key-value entry and block as its own record in a records.Store, the shape of an IndexedDB object store.
|
Package direct is a volume engine that stores every key-value entry and block as its own record in a records.Store, the shape of an IndexedDB object store. |
|
volume/idb
Package volume_idb implements a chunked device.Device on IndexedDB for the browser volume.
|
Package volume_idb implements a chunked device.Device on IndexedDB for the browser volume. |
|
volume/logindex
Package logindex is an ordered key-value index on a storage Device that keeps the whole table in memory and writes it as a log.
|
Package logindex is an ordered key-value index on a storage Device that keeps the whole table in memory and writes it as a log. |
|
volume/memtable
Package memtable is an in-memory ordered key-value table with copy-on-write snapshots, which its owner persists through a commit function.
|
Package memtable is an in-memory ordered key-value table with copy-on-write snapshots, which its owner persists through a commit function. |
|
volume/paylog
Package paylog is a volume engine shell over a storage Device: block payloads append to a log of segment files, and one ordered index holds the key-value store and the block locations.
|
Package paylog is a volume engine shell over a storage Device: block payloads append to a log of segment files, and one ordered index holds the key-value store and the block locations. |
|
volume/records
Package records defines the ordered record store an IndexedDB object store provides, with a memory implementation that simulates power loss.
|
Package records defines the ordered record store an IndexedDB object store provides, with a memory implementation that simulates power loss. |
|
volume/records/recordstest
Package recordstest checks a records.Store against its contract, so native tests and browser fixtures run the same checks on every implementation.
|
Package recordstest checks a records.Store against its contract, so native tests and browser fixtures run the same checks on every implementation. |
|
volume/s4db
Package volume_s4db implements the Volume on one s4db database file.
|
Package volume_s4db implements the Volume on one s4db database file. |
|
volume/scoped
Package volume_scoped serves a view of a volume that reaches only the data of one owner.
|
Package volume_scoped serves a view of a volume that reaches only the data of one owner. |
|
volume/workload
Package workload records the logical operations a Volume's storage engine serves, as runtime/trace log events, so the workload captured from a running app can be extracted from its execution trace and replayed against another engine.
|
Package workload records the logical operations a Volume's storage engine serves, as runtime/trace log events, so the workload captured from a running app can be extracted from its execution trace and replayed against another engine. |
|
Package dev provides the spacewave-dev command surface for downstream applications that build on spacewave.
|
Package dev provides the spacewave-dev command surface for downstream applications that build on spacewave. |
|
e2e
|
|
|
drivebench
Package drivebench owns the run.json artifact schema shared by the Drive startup benches.
|
Package drivebench owns the run.json artifact schema shared by the Drive startup benches. |
|
electron
Package electron provides an opt-in Electron E2E harness backed by the existing Bldr desktop runtime.
|
Package electron provides an opt-in Electron E2E harness backed by the existing Bldr desktop runtime. |
|
electron/cdpretry
Package cdpretry contains the Electron renderer CDP retry policy.
|
Package cdpretry contains the Electron renderer CDP retry policy. |
|
releasewasm/cmd/publish-artifact
command
|
|
|
runtime
Package runtime defines the user-facing contract shared by every E2E runtime adapter.
|
Package runtime defines the user-facing contract shared by every E2E runtime adapter. |
|
runtime/devwasm
Package devwasm adapts the existing browser WASM harness to the scenario runtime contract.
|
Package devwasm adapts the existing browser WASM harness to the scenario runtime contract. |
|
scenario
Package scenario owns the compile-time catalog of cross-runtime user flows.
|
Package scenario owns the compile-time catalog of cross-runtime user flows. |
|
shareddaemon/prepare
command
Command prepare builds the shared-daemon fixture with the production Electron shell.
|
Command prepare builds the shared-daemon fixture with the production Electron shell. |
|
wasm
Package wasm provides a Go test harness that boots the real bldr start:web:wasm lifecycle and exposes the running app for e2e testing.
|
Package wasm provides a Go test harness that boots the real bldr start:web:wasm lifecycle and exposes the running app for e2e testing. |
|
wasm/memlab
Package memlab provides heap snapshot capture via Chrome DevTools Protocol and analysis via @memlab/heap-analysis for memory leak detection in e2e tests.
|
Package memlab provides heap snapshot capture via Chrome DevTools Protocol and analysis via @memlab/heap-analysis for memory leak detection in e2e tests. |
|
cmd/forge
command
|
|
|
examples/run-execution
command
|
|
|
examples/run-worker
command
|
|
|
lib/v86/wazero/usernet
Package usernet implements a small usermode L2 network stack for v86 guests.
|
Package usernet implements a small usermode L2 network stack for v86 guests. |
|
net
|
|
|
cmd/bifrost
command
|
|
|
crypto
Package crypto implements cryptographic key utilities for bifrost.
|
Package crypto implements cryptographic key utilities for bifrost. |
|
crypto/tls
Package p2ptls provides TLS identity for bifrost peer authentication.
|
Package p2ptls provides TLS identity for bifrost peer authentication. |
|
examples/mesh-chat
command
mesh-chat demonstrates decentralized peer-to-peer messaging.
|
mesh-chat demonstrates decentralized peer-to-peer messaging. |
|
examples/udp-link
command
|
|
|
signaling/rpc/frame
Package signaling_rpc_frame carries srpc streams over one WebSocket with one Frame per binary message.
|
Package signaling_rpc_frame carries srpc streams over one WebSocket with one Frame per binary message. |
|
sim/graph
Package graph and sub-packages contain a virtual representation of a graph of connected networks and nodes.
|
Package graph and sub-packages contain a virtual representation of a graph of connected networks and nodes. |
|
sim/tests/bifrost
Package bifrost anchors the end-to-end bifrost simulator test package.
|
Package bifrost anchors the end-to-end bifrost simulator test package. |
|
stream/datagram
Package stream_datagram forwards UDP packets over an established peer message stream.
|
Package stream_datagram forwards UDP packets over an established peer message stream. |
|
plugin
|
|
|
flowgraph
Package flowgraph_plugin supplies the Stream Echo Device node and its settings editor.
|
Package flowgraph_plugin supplies the Stream Echo Device node and its settings editor. |
|
prom
Package prom_plugin stores Prometheus samples in a World, scrapes exporters into it from approved Devices, and answers PromQL over it.
|
Package prom_plugin stores Prometheus samples in a World, scrapes exporters into it from approved Devices, and answers PromQL over it. |
|
wasivm
Package wasivm_plugin serves WasiVM virtual machines to the Spaces that load the spacewave-wasivm plugin.
|
Package wasivm_plugin serves WasiVM virtual machines to the Spaces that load the spacewave-wasivm plugin. |
|
wasivm/binpkg
Package binpkg reads Gentoo binary packages: the Packages index of a binary package directory, the runtime closure of a set of packages, and the files of each GPKG archive split into runtime and dev layers.
|
Package binpkg reads Gentoo binary packages: the Packages index of a binary package directory, the runtime closure of a set of packages, and the files of each GPKG archive split into runtime and dev layers. |
|
wasivm/cmd/wasivm
command
Command wasivm runs a WebAssembly program under the WasiVM kernel, for debugging the kernel outside Spacewave.
|
Command wasivm runs a WebAssembly program under the WasiVM kernel, for debugging the kernel outside Spacewave. |
|
wasivm/display
Package display is a host X client of the X server running in a WasiVM.
|
Package display is a host X client of the X server running in a WasiVM. |
|
wasivm/kernel
Package kernel runs Linux programs compiled to WebAssembly.
|
Package kernel runs Linux programs compiled to WebAssembly. |
|
wasivm/kernel/engine
Package engine defines the WebAssembly engine the kernel runs guests on.
|
Package engine defines the WebAssembly engine the kernel runs guests on. |
|
wasivm/kernel/engine/browser
Package browser runs kernel guests on the browser's WebAssembly API.
|
Package browser runs kernel guests on the browser's WebAssembly API. |
|
wasivm/kernel/engine/native
Package native runs kernel guests on wazero.
|
Package native runs kernel guests on wazero. |
|
wasivm/layer
Package layer builds UnixFS layers from file entries and lays layers onto a root by reference.
|
Package layer builds UnixFS layers from file entries and lays layers onto a root by reference. |
|
wasivm/wayland
Package wayland is a Wayland compositor for the clients in a WasiVM.
|
Package wayland is a Wayland compositor for the clients in a WasiVM. |
|
prototypes
|
|
|
git-clone-test
command
|
|
|
opfs/bench
Package bench contains OPFS storage benchmarks for browser WASM.
|
Package bench contains OPFS storage benchmarks for browser WASM. |
|
opfs/go-opfs
Package opfs provides Go wrappers for the Origin Private File System browser API.
|
Package opfs provides Go wrappers for the Origin Private File System browser API. |
|
opfs/store
Package store implements a kvtx.Store backed by OPFS flat files.
|
Package store implements a kvtx.Store backed by OPFS flat files. |
|
Package runtimeenv resolves process-local performance policy from runtime facts.
|
Package runtimeenv resolves process-local performance policy from runtime facts. |
|
scripts
|
|
|
sync-library
command
Command sync-library compiles and bundles the standalone npm package.
|
Command sync-library compiles and bundles the standalone npm package. |
|
sdk
|
|
|
alarm
Package s4wave_alarm is the contract of Alarms: objects that flag a condition while it holds and resolve when it clears.
|
Package s4wave_alarm is the contract of Alarms: objects that flag a condition while it holds and resolve when it clears. |
|
alarm/volume
Package alarm_volume defines the Alarms on store health: a volume stuck in one collection phase, a volume whose free disk will reach its reserve soon, and a volume that refuses writes at its reserve.
|
Package alarm_volume defines the Alarms on store health: a volume stuck in one collection phase, a volume whose free disk will reach its reserve soon, and a volume that refuses writes at its reserve. |
|
appconnector
Package s4wave_appconnector holds the AppConnector and AppSnapshot objects.
|
Package s4wave_appconnector holds the AppConnector and AppSnapshot objects. |
|
appconnector/world
Package s4wave_appconnector_world registers the AppConnector and AppSnapshot ObjectTypes.
|
Package s4wave_appconnector_world registers the AppConnector and AppSnapshot ObjectTypes. |
|
apt
Package s4wave_apt implements apt repository block types and world operations.
|
Package s4wave_apt implements apt repository block types and world operations. |
|
flowgraph
Package s4wave_flowgraph stores and edits authored compositions in a World.
|
Package s4wave_flowgraph stores and edits authored compositions in a World. |
|
flowgraph/registry
Package flowgraph_registry carries plugin node declarations and compiler RPCs.
|
Package flowgraph_registry carries plugin node declarations and compiler RPCs. |
|
flowgraph/run
Package flowgraph_run drives the Steps of a Flowgraph run on a Forge Job.
|
Package flowgraph_run drives the Steps of a Flowgraph run on a Forge Job. |
|
forge/world
Package s4wave_forge_world registers Forge ObjectTypes in the Space World.
|
Package s4wave_forge_world registers Forge ObjectTypes in the Space World. |
|
function
Package s4wave_function is the contract of PureFunctions: TypeScript modules that turn protobuf input into protobuf output under a memory and instruction budget, and run the same on a Go daemon and in a browser.
|
Package s4wave_function is the contract of PureFunctions: TypeScript modules that turn protobuf input into protobuf output under a memory and instruction budget, and run the same on a Go daemon and in a browser. |
|
function/run
Package function_run runs PureFunctions in the QuickJS-NG WASI reactor under wazero.
|
Package function_run runs PureFunctions in the QuickJS-NG WASI reactor under wazero. |
|
prom
Package s4wave_prom is the contract of Spacewave's Prometheus metrics: the prom/target ObjectType, the parts of its key-value tree that clients read, and the PromQL query service of the spacewave-prom plugin.
|
Package s4wave_prom is the contract of Spacewave's Prometheus metrics: the prom/target ObjectType, the parts of its key-value tree that clients read, and the PromQL query service of the spacewave-prom plugin. |
|
sshhost
SSH host-key trust pins parse and fingerprint authorized_keys via golang.org/x/crypto/ssh, which pulls reflect through its wire codec.
|
SSH host-key trust pins parse and fingerprint authorized_keys via golang.org/x/crypto/ssh, which pulls reflect through its wire codec. |
|
vm
Package s4wave_vm implements the VM block types and world operations.
|
Package s4wave_vm implements the VM block types and world operations. |
|
vm/world
Package s4wave_vm_world registers VM ObjectTypes in the Space World.
|
Package s4wave_vm_world registers VM ObjectTypes in the Space World. |
Click to show internal directories.
Click to hide internal directories.