Skip to main content

Working with WonderForge

WonderForge is a platform for creating and managing structured content of any kind. Because everything in the system is an artifact with a uniform set of operations, you can model whatever you need -- applications, workflows, data systems, creative projects, documentation, infrastructure -- using the same building blocks.

These guides are organized around what you want to accomplish, not around individual artifact types. There are two main paths through this section depending on what you are trying to do.

Creating and organizing artifacts​

If you want to use the platform to model and manage your own content, start here:

  • Creating Artifact Types -- Define custom types that describe the structure of your data. Once a type exists, you can create instances of it immediately, and the platform enforces your schema on every change.
  • Connecting Artifacts with Flux -- Choose the right relationship type to connect artifacts together. Flux handles everything from strict parent-child ownership to loose "see also" links, with lifecycle protection built in.
  • Tutorial: Building a TODO App -- A step-by-step walkthrough that builds a TODO application from scratch, introducing types, flux, events, subscriptions, lenses, and agent integration one phase at a time.
  • Tutorial: The Build & Deploy Pipeline -- How CBFS, Kubernetes Jobs, and the container registry work together to go from source code to a running service, using built-in subscription pipelines.

Extending the platform with lenses​

If you want to build custom visual interfaces for your artifact types, the lens system lets you do that without modifying the platform itself. Lenses are a core part of the platform — see the Lenses section for the full documentation, including the Lens SDK, installation, API proxy, and menu items.

Prerequisites​

These guides assume familiarity with the core concepts covered in the platform section. If terms like "artifact," "flux," or "artifact type definition" are unfamiliar, start there first. The platform section explains the foundational ideas; this section shows you how to put them into practice.