Guides

Linear, task-oriented, Foundry-based walkthroughs that link into the concept graph for depth. Read a guide top to bottom; follow its links when you want the underlying detail. (The one exception to "Foundry-based" is the narrative Why OSx, which has no code.)

Follow the reading order below, with links to the concepts each guide uses.

Before you start: Setup, the one-time Foundry project scaffold (start from the template, point at a deployed protocol) that every guide below assumes.

Understand

• Why OSx: the organization that can reinvent itself — how a small core, replaceable plugins, and one permission layer let an organization change over time.
• A hands-on tour of OSx — deploy a DAO, fund it, make it execute an action, and see how a permission controls the call.

Use and operate a DAO

• Deploy your first DAO — a bare DAO (you hold EXECUTE), then the same flow with a governance plugin installed in one transaction.
• Launch a governance token with your DAO — deploy with Token Voting and the three token paths (mint new, reuse an IVotes token, or wrap a plain ERC-20), accounting for delegation and clock requirements.
• Import an existing token — choose direct reuse or wrapping, install Token Voting, and prepare holders to vote.
• Create, vote, and execute a proposal — the shared proposal lifecycle, then the multisig and token-voting specifics.
• Manage permissions through governance — grant/revoke as a proposal, attach a condition, rotate one safely in a single batch, and write a small custom condition.
• Install a plugin into a live DAO — the prepare → (temporary ROOT to the PSP) → apply → revoke flow, as a governed proposal.
• Update a plugin — prepare + apply via governance, the release/build rules, and the metadata-only fast path (and uninstalling).

Build a plugin

• Build a plugin — from the template: pick a base type, write the plugin's auth-gated logic, and write its PluginSetup (the permission arrays).
• Publish a plugin to a PluginRepo — first version 1.1, release vs build, metadata, and the registry.

Related concepts

For details on composing multi-stage governance with the SPP, gating permissions with the ready-made condition library, and deploying the whole protocol on a new chain, follow the linked concepts.