Omnistac · bowheart · Feb 23, 2026
diff --git a/docs/docs/next/index.mdx b/docs/docs/next/index.mdx
@@ -0,0 +1,8 @@
+---
+id: index
+title: Next (Unreleased) Documentation
+---
+
+# Next (Unreleased) Documentation
+
+This documentation is for the upcoming release and may change.
diff --git a/docs/docs/about/faq.mdx → docs/docs/v1/about/faq.mdx b/docs/docs/about/faq.mdx → docs/docs/v1/about/faq.mdx
diff --git a/docs/docs/about/introduction.mdx → docs/docs/v1/about/introduction.mdx b/docs/docs/about/introduction.mdx → docs/docs/v1/about/introduction.mdx
diff --git a/docs/docs/about/react-query-comparison.mdx → .../docs/v1/about/react-query-comparison.mdx b/docs/docs/about/react-query-comparison.mdx → .../docs/v1/about/react-query-comparison.mdx
diff --git a/docs/docs/about/recoil-comparison.mdx → docs/docs/v1/about/recoil-comparison.mdx b/docs/docs/about/recoil-comparison.mdx → docs/docs/v1/about/recoil-comparison.mdx
diff --git a/docs/docs/about/redux-comparison.mdx → docs/docs/v1/about/redux-comparison.mdx b/docs/docs/about/redux-comparison.mdx → docs/docs/v1/about/redux-comparison.mdx
diff --git a/docs/docs/advanced/batching.mdx → docs/docs/v1/advanced/batching.mdx b/docs/docs/advanced/batching.mdx → docs/docs/v1/advanced/batching.mdx
diff --git a/docs/docs/advanced/complex-params.mdx → docs/docs/v1/advanced/complex-params.mdx b/docs/docs/advanced/complex-params.mdx → docs/docs/v1/advanced/complex-params.mdx
diff --git a/docs/docs/advanced/dev-tools.mdx → docs/docs/v1/advanced/dev-tools.mdx b/docs/docs/advanced/dev-tools.mdx → docs/docs/v1/advanced/dev-tools.mdx
diff --git a/docs/docs/advanced/more-patterns.mdx → docs/docs/v1/advanced/more-patterns.mdx b/docs/docs/advanced/more-patterns.mdx → docs/docs/v1/advanced/more-patterns.mdx
diff --git a/docs/docs/advanced/persistence.mdx → docs/docs/v1/advanced/persistence.mdx b/docs/docs/advanced/persistence.mdx → docs/docs/v1/advanced/persistence.mdx
diff --git a/docs/docs/advanced/plugins.mdx → docs/docs/v1/advanced/plugins.mdx b/docs/docs/advanced/plugins.mdx → docs/docs/v1/advanced/plugins.mdx
diff --git a/docs/docs/advanced/ssr.mdx → docs/docs/v1/advanced/ssr.mdx b/docs/docs/advanced/ssr.mdx → docs/docs/v1/advanced/ssr.mdx
diff --git a/docs/docs/advanced/store-composition.mdx → docs/docs/v1/advanced/store-composition.mdx b/docs/docs/advanced/store-composition.mdx → docs/docs/v1/advanced/store-composition.mdx
diff --git a/docs/docs/advanced/time-travel.mdx → docs/docs/v1/advanced/time-travel.mdx b/docs/docs/advanced/time-travel.mdx → docs/docs/v1/advanced/time-travel.mdx
diff --git a/docs/docs/advanced/typescript-tips.mdx → docs/docs/v1/advanced/typescript-tips.mdx b/docs/docs/advanced/typescript-tips.mdx → docs/docs/v1/advanced/typescript-tips.mdx
diff --git a/docs/docs/api/api-overview.md → docs/docs/v1/api/api-overview.md b/docs/docs/api/api-overview.md → docs/docs/v1/api/api-overview.md
diff --git a/docs/docs/api/classes/AtomApi.mdx → docs/docs/v1/api/classes/AtomApi.mdx b/docs/docs/api/classes/AtomApi.mdx → docs/docs/v1/api/classes/AtomApi.mdx
diff --git a/docs/docs/api/classes/AtomInstance.mdx → docs/docs/v1/api/classes/AtomInstance.mdx b/docs/docs/api/classes/AtomInstance.mdx → docs/docs/v1/api/classes/AtomInstance.mdx
diff --git a/docs/docs/api/classes/AtomTemplate.mdx → docs/docs/v1/api/classes/AtomTemplate.mdx b/docs/docs/api/classes/AtomTemplate.mdx → docs/docs/v1/api/classes/AtomTemplate.mdx
diff --git a/docs/docs/api/classes/Ecosystem.mdx → docs/docs/v1/api/classes/Ecosystem.mdx b/docs/docs/api/classes/Ecosystem.mdx → docs/docs/v1/api/classes/Ecosystem.mdx
diff --git a/docs/docs/api/classes/IonTemplate.mdx → docs/docs/v1/api/classes/IonTemplate.mdx b/docs/docs/api/classes/IonTemplate.mdx → docs/docs/v1/api/classes/IonTemplate.mdx
diff --git a/docs/docs/api/classes/SelectorCache.mdx → docs/docs/v1/api/classes/SelectorCache.mdx b/docs/docs/api/classes/SelectorCache.mdx → docs/docs/v1/api/classes/SelectorCache.mdx
diff --git a/docs/docs/api/classes/Selectors.mdx → docs/docs/v1/api/classes/Selectors.mdx b/docs/docs/api/classes/Selectors.mdx → docs/docs/v1/api/classes/Selectors.mdx
diff --git a/docs/docs/api/classes/Store.mdx → docs/docs/v1/api/classes/Store.mdx b/docs/docs/api/classes/Store.mdx → docs/docs/v1/api/classes/Store.mdx
diff --git a/docs/docs/api/classes/ZeduxPlugin.mdx → docs/docs/v1/api/classes/ZeduxPlugin.mdx b/docs/docs/api/classes/ZeduxPlugin.mdx → docs/docs/v1/api/classes/ZeduxPlugin.mdx
diff --git a/docs/docs/api/components/AtomProvider.mdx → docs/docs/v1/api/components/AtomProvider.mdx b/docs/docs/api/components/AtomProvider.mdx → docs/docs/v1/api/components/AtomProvider.mdx
diff --git a/...docs/api/components/EcosystemProvider.mdx → ...s/v1/api/components/EcosystemProvider.mdx b/...docs/api/components/EcosystemProvider.mdx → ...s/v1/api/components/EcosystemProvider.mdx
diff --git a/docs/docs/api/factories/actionFactory.mdx → docs/docs/v1/api/factories/actionFactory.mdx b/docs/docs/api/factories/actionFactory.mdx → docs/docs/v1/api/factories/actionFactory.mdx
diff --git a/docs/docs/api/factories/api.mdx → docs/docs/v1/api/factories/api.mdx b/docs/docs/api/factories/api.mdx → docs/docs/v1/api/factories/api.mdx
diff --git a/docs/docs/api/factories/atom.mdx → docs/docs/v1/api/factories/atom.mdx b/docs/docs/api/factories/atom.mdx → docs/docs/v1/api/factories/atom.mdx
diff --git a/docs/docs/api/factories/createEcosystem.mdx → ...docs/v1/api/factories/createEcosystem.mdx b/docs/docs/api/factories/createEcosystem.mdx → ...docs/v1/api/factories/createEcosystem.mdx
diff --git a/docs/docs/api/factories/createReducer.mdx → docs/docs/v1/api/factories/createReducer.mdx b/docs/docs/api/factories/createReducer.mdx → docs/docs/v1/api/factories/createReducer.mdx
diff --git a/docs/docs/api/factories/createStore.mdx → docs/docs/v1/api/factories/createStore.mdx b/docs/docs/api/factories/createStore.mdx → docs/docs/v1/api/factories/createStore.mdx
diff --git a/docs/docs/api/factories/ion.mdx → docs/docs/v1/api/factories/ion.mdx b/docs/docs/api/factories/ion.mdx → docs/docs/v1/api/factories/ion.mdx
diff --git a/docs/docs/api/glossary.md → docs/docs/v1/api/glossary.md b/docs/docs/api/glossary.md → docs/docs/v1/api/glossary.md
diff --git a/docs/docs/api/hooks/useAtomContext.mdx → docs/docs/v1/api/hooks/useAtomContext.mdx b/docs/docs/api/hooks/useAtomContext.mdx → docs/docs/v1/api/hooks/useAtomContext.mdx
diff --git a/docs/docs/api/hooks/useAtomInstance.mdx → docs/docs/v1/api/hooks/useAtomInstance.mdx b/docs/docs/api/hooks/useAtomInstance.mdx → docs/docs/v1/api/hooks/useAtomInstance.mdx
diff --git a/docs/docs/api/hooks/useAtomSelector.mdx → docs/docs/v1/api/hooks/useAtomSelector.mdx b/docs/docs/api/hooks/useAtomSelector.mdx → docs/docs/v1/api/hooks/useAtomSelector.mdx
diff --git a/docs/docs/api/hooks/useAtomState.mdx → docs/docs/v1/api/hooks/useAtomState.mdx b/docs/docs/api/hooks/useAtomState.mdx → docs/docs/v1/api/hooks/useAtomState.mdx
diff --git a/docs/docs/api/hooks/useAtomValue.mdx → docs/docs/v1/api/hooks/useAtomValue.mdx b/docs/docs/api/hooks/useAtomValue.mdx → docs/docs/v1/api/hooks/useAtomValue.mdx
diff --git a/docs/docs/api/hooks/useEcosystem.mdx → docs/docs/v1/api/hooks/useEcosystem.mdx b/docs/docs/api/hooks/useEcosystem.mdx → docs/docs/v1/api/hooks/useEcosystem.mdx
diff --git a/.../docs/api/injectors/injectAtomGetters.mdx → ...cs/v1/api/injectors/injectAtomGetters.mdx b/.../docs/api/injectors/injectAtomGetters.mdx → ...cs/v1/api/injectors/injectAtomGetters.mdx
diff --git a/...docs/api/injectors/injectAtomInstance.mdx → ...s/v1/api/injectors/injectAtomInstance.mdx b/...docs/api/injectors/injectAtomInstance.mdx → ...s/v1/api/injectors/injectAtomInstance.mdx
diff --git a/...docs/api/injectors/injectAtomSelector.mdx → ...s/v1/api/injectors/injectAtomSelector.mdx b/...docs/api/injectors/injectAtomSelector.mdx → ...s/v1/api/injectors/injectAtomSelector.mdx
diff --git a/docs/docs/api/injectors/injectAtomState.mdx → ...docs/v1/api/injectors/injectAtomState.mdx b/docs/docs/api/injectors/injectAtomState.mdx → ...docs/v1/api/injectors/injectAtomState.mdx
diff --git a/docs/docs/api/injectors/injectAtomValue.mdx → ...docs/v1/api/injectors/injectAtomValue.mdx b/docs/docs/api/injectors/injectAtomValue.mdx → ...docs/v1/api/injectors/injectAtomValue.mdx
diff --git a/docs/docs/api/injectors/injectCallback.mdx → .../docs/v1/api/injectors/injectCallback.mdx b/docs/docs/api/injectors/injectCallback.mdx → .../docs/v1/api/injectors/injectCallback.mdx
diff --git a/docs/docs/api/injectors/injectEffect.mdx → docs/docs/v1/api/injectors/injectEffect.mdx b/docs/docs/api/injectors/injectEffect.mdx → docs/docs/v1/api/injectors/injectEffect.mdx
diff --git a/docs/docs/api/injectors/injectInvalidate.mdx → ...ocs/v1/api/injectors/injectInvalidate.mdx b/docs/docs/api/injectors/injectInvalidate.mdx → ...ocs/v1/api/injectors/injectInvalidate.mdx
diff --git a/docs/docs/api/injectors/injectMemo.mdx → docs/docs/v1/api/injectors/injectMemo.mdx b/docs/docs/api/injectors/injectMemo.mdx → docs/docs/v1/api/injectors/injectMemo.mdx
diff --git a/docs/docs/api/injectors/injectPromise.mdx → docs/docs/v1/api/injectors/injectPromise.mdx b/docs/docs/api/injectors/injectPromise.mdx → docs/docs/v1/api/injectors/injectPromise.mdx
diff --git a/docs/docs/api/injectors/injectRef.mdx → docs/docs/v1/api/injectors/injectRef.mdx b/docs/docs/api/injectors/injectRef.mdx → docs/docs/v1/api/injectors/injectRef.mdx
diff --git a/docs/docs/api/injectors/injectSelf.mdx → docs/docs/v1/api/injectors/injectSelf.mdx b/docs/docs/api/injectors/injectSelf.mdx → docs/docs/v1/api/injectors/injectSelf.mdx
diff --git a/docs/docs/api/injectors/injectStore.mdx → docs/docs/v1/api/injectors/injectStore.mdx b/docs/docs/api/injectors/injectStore.mdx → docs/docs/v1/api/injectors/injectStore.mdx
diff --git a/docs/docs/api/injectors/injectWhy.mdx → docs/docs/v1/api/injectors/injectWhy.mdx b/docs/docs/api/injectors/injectWhy.mdx → docs/docs/v1/api/injectors/injectWhy.mdx
diff --git a/docs/docs/api/types/Action.mdx → docs/docs/v1/api/types/Action.mdx b/docs/docs/api/types/Action.mdx → docs/docs/v1/api/types/Action.mdx
diff --git a/docs/docs/api/types/ActionChain.mdx → docs/docs/v1/api/types/ActionChain.mdx b/docs/docs/api/types/ActionChain.mdx → docs/docs/v1/api/types/ActionChain.mdx
diff --git a/docs/docs/api/types/ActionFactory.mdx → docs/docs/v1/api/types/ActionFactory.mdx b/docs/docs/api/types/ActionFactory.mdx → docs/docs/v1/api/types/ActionFactory.mdx
diff --git a/docs/docs/api/types/AtomConfig.mdx → docs/docs/v1/api/types/AtomConfig.mdx b/docs/docs/api/types/AtomConfig.mdx → docs/docs/v1/api/types/AtomConfig.mdx
diff --git a/docs/docs/api/types/AtomGetters.mdx → docs/docs/v1/api/types/AtomGetters.mdx b/docs/docs/api/types/AtomGetters.mdx → docs/docs/v1/api/types/AtomGetters.mdx
diff --git a/docs/docs/api/types/AtomInstanceTtl.mdx → docs/docs/v1/api/types/AtomInstanceTtl.mdx b/docs/docs/api/types/AtomInstanceTtl.mdx → docs/docs/v1/api/types/AtomInstanceTtl.mdx
diff --git a/docs/docs/api/types/AtomSelector.mdx → docs/docs/v1/api/types/AtomSelector.mdx b/docs/docs/api/types/AtomSelector.mdx → docs/docs/v1/api/types/AtomSelector.mdx
diff --git a/docs/docs/api/types/AtomSelectorConfig.mdx → .../docs/v1/api/types/AtomSelectorConfig.mdx b/docs/docs/api/types/AtomSelectorConfig.mdx → .../docs/v1/api/types/AtomSelectorConfig.mdx
diff --git a/docs/docs/api/types/DependentCallback.mdx → docs/docs/v1/api/types/DependentCallback.mdx b/docs/docs/api/types/DependentCallback.mdx → docs/docs/v1/api/types/DependentCallback.mdx
diff --git a/docs/docs/api/types/EcosystemConfig.mdx → docs/docs/v1/api/types/EcosystemConfig.mdx b/docs/docs/api/types/EcosystemConfig.mdx → docs/docs/v1/api/types/EcosystemConfig.mdx
diff --git a/docs/docs/api/types/EvaluationReason.mdx → docs/docs/v1/api/types/EvaluationReason.mdx b/docs/docs/api/types/EvaluationReason.mdx → docs/docs/v1/api/types/EvaluationReason.mdx
diff --git a/docs/docs/api/types/HierarchyDescriptor.mdx → ...docs/v1/api/types/HierarchyDescriptor.mdx b/docs/docs/api/types/HierarchyDescriptor.mdx → ...docs/v1/api/types/HierarchyDescriptor.mdx
diff --git a/docs/docs/api/types/PromiseState.mdx → docs/docs/v1/api/types/PromiseState.mdx b/docs/docs/api/types/PromiseState.mdx → docs/docs/v1/api/types/PromiseState.mdx
diff --git a/docs/docs/api/types/Reducer.mdx → docs/docs/v1/api/types/Reducer.mdx b/docs/docs/api/types/Reducer.mdx → docs/docs/v1/api/types/Reducer.mdx
diff --git a/docs/docs/api/types/ReducerBuilder.mdx → docs/docs/v1/api/types/ReducerBuilder.mdx b/docs/docs/api/types/ReducerBuilder.mdx → docs/docs/v1/api/types/ReducerBuilder.mdx
diff --git a/docs/docs/api/types/Settable.mdx → docs/docs/v1/api/types/Settable.mdx b/docs/docs/api/types/Settable.mdx → docs/docs/v1/api/types/Settable.mdx
diff --git a/docs/docs/api/types/StoreEffect.mdx → docs/docs/v1/api/types/StoreEffect.mdx b/docs/docs/api/types/StoreEffect.mdx → docs/docs/v1/api/types/StoreEffect.mdx
diff --git a/docs/docs/api/types/Subscriber.mdx → docs/docs/v1/api/types/Subscriber.mdx b/docs/docs/api/types/Subscriber.mdx → docs/docs/v1/api/types/Subscriber.mdx
diff --git a/docs/docs/api/types/Subscription.mdx → docs/docs/v1/api/types/Subscription.mdx b/docs/docs/api/types/Subscription.mdx → docs/docs/v1/api/types/Subscription.mdx
diff --git a/docs/docs/api/utils/action-chain-utils.mdx → .../docs/v1/api/utils/action-chain-utils.mdx b/docs/docs/api/utils/action-chain-utils.mdx → .../docs/v1/api/utils/action-chain-utils.mdx
diff --git a/docs/docs/api/utils/internal-utils.mdx → docs/docs/v1/api/utils/internal-utils.mdx b/docs/docs/api/utils/internal-utils.mdx → docs/docs/v1/api/utils/internal-utils.mdx
diff --git a/docs/docs/api/utils/is.mdx → docs/docs/v1/api/utils/is.mdx b/docs/docs/api/utils/is.mdx → docs/docs/v1/api/utils/is.mdx
diff --git a/docs/docs/api/utils/zeduxTypes.mdx → docs/docs/v1/api/utils/zeduxTypes.mdx b/docs/docs/api/utils/zeduxTypes.mdx → docs/docs/v1/api/utils/zeduxTypes.mdx
diff --git a/docs/docs/v1/index.mdx b/docs/docs/v1/index.mdx
@@ -0,0 +1,18 @@
+---
+id: index
+title: v1 Documentation
+slug: /
+sidebar_label: Overview
+---
+
+# Zedux v1 Documentation
+
+Welcome to the v1 documentation. This is for the old store-based API. For the new signal-based API, see the [v2 documentation](/docs/v2/).
+
+## Getting Started
+
+The complete v1 documentation starts at [Quick Start](/docs/v1/walkthrough/quick-start).
+
+## Migration Guide
+
+If you're upgrading from v1 to v2, see the [Migration Guide](/docs/v1/migrations/v2).
diff --git a/docs/docs/migrations/v2.mdx → docs/docs/v1/migrations/v2.mdx b/docs/docs/migrations/v2.mdx → docs/docs/v1/migrations/v2.mdx
diff --git a/docs/docs/packages/immer.mdx → docs/docs/v1/packages/immer.mdx b/docs/docs/packages/immer.mdx → docs/docs/v1/packages/immer.mdx
diff --git a/docs/docs/packages/machines/MachineState.mdx → ...ocs/v1/packages/machines/MachineState.mdx b/docs/docs/packages/machines/MachineState.mdx → ...ocs/v1/packages/machines/MachineState.mdx
diff --git a/docs/docs/packages/machines/MachineStore.mdx → ...ocs/v1/packages/machines/MachineStore.mdx b/docs/docs/packages/machines/MachineStore.mdx → ...ocs/v1/packages/machines/MachineStore.mdx
diff --git a/.../packages/machines/injectMachineStore.mdx → .../packages/machines/injectMachineStore.mdx b/.../packages/machines/injectMachineStore.mdx → .../packages/machines/injectMachineStore.mdx
diff --git a/docs/docs/packages/machines/overview.mdx → docs/docs/v1/packages/machines/overview.mdx b/docs/docs/packages/machines/overview.mdx → docs/docs/v1/packages/machines/overview.mdx
diff --git a/docs/docs/packages/machines/walkthrough.mdx → ...docs/v1/packages/machines/walkthrough.mdx b/docs/docs/packages/machines/walkthrough.mdx → ...docs/v1/packages/machines/walkthrough.mdx
diff --git a/docs/docs/walkthrough/atom-apis.mdx → docs/docs/v1/walkthrough/atom-apis.mdx b/docs/docs/walkthrough/atom-apis.mdx → docs/docs/v1/walkthrough/atom-apis.mdx
diff --git a/docs/docs/walkthrough/atom-getters.mdx → docs/docs/v1/walkthrough/atom-getters.mdx b/docs/docs/walkthrough/atom-getters.mdx → docs/docs/v1/walkthrough/atom-getters.mdx
diff --git a/docs/docs/walkthrough/atom-instances.mdx → docs/docs/v1/walkthrough/atom-instances.mdx b/docs/docs/walkthrough/atom-instances.mdx → docs/docs/v1/walkthrough/atom-instances.mdx
diff --git a/docs/docs/walkthrough/atom-state.mdx → docs/docs/v1/walkthrough/atom-state.mdx b/docs/docs/walkthrough/atom-state.mdx → docs/docs/v1/walkthrough/atom-state.mdx
diff --git a/docs/docs/walkthrough/configuring-atoms.mdx → ...docs/v1/walkthrough/configuring-atoms.mdx b/docs/docs/walkthrough/configuring-atoms.mdx → ...docs/v1/walkthrough/configuring-atoms.mdx
diff --git a/docs/docs/walkthrough/custom-injectors.mdx → .../docs/v1/walkthrough/custom-injectors.mdx b/docs/docs/walkthrough/custom-injectors.mdx → .../docs/v1/walkthrough/custom-injectors.mdx
diff --git a/docs/docs/walkthrough/destruction.mdx → docs/docs/v1/walkthrough/destruction.mdx b/docs/docs/walkthrough/destruction.mdx → docs/docs/v1/walkthrough/destruction.mdx
diff --git a/docs/docs/walkthrough/ecosystems.mdx → docs/docs/v1/walkthrough/ecosystems.mdx b/docs/docs/walkthrough/ecosystems.mdx → docs/docs/v1/walkthrough/ecosystems.mdx
diff --git a/docs/docs/walkthrough/overrides.mdx → docs/docs/v1/walkthrough/overrides.mdx b/docs/docs/walkthrough/overrides.mdx → docs/docs/v1/walkthrough/overrides.mdx
diff --git a/docs/docs/walkthrough/query-atoms.mdx → docs/docs/v1/walkthrough/query-atoms.mdx b/docs/docs/walkthrough/query-atoms.mdx → docs/docs/v1/walkthrough/query-atoms.mdx
diff --git a/docs/docs/walkthrough/quick-start.mdx → docs/docs/v1/walkthrough/quick-start.mdx b/docs/docs/walkthrough/quick-start.mdx → docs/docs/v1/walkthrough/quick-start.mdx
diff --git a/docs/docs/walkthrough/react-context.mdx → docs/docs/v1/walkthrough/react-context.mdx b/docs/docs/walkthrough/react-context.mdx → docs/docs/v1/walkthrough/react-context.mdx
diff --git a/docs/docs/walkthrough/resets.mdx → docs/docs/v1/walkthrough/resets.mdx b/docs/docs/walkthrough/resets.mdx → docs/docs/v1/walkthrough/resets.mdx
diff --git a/docs/docs/walkthrough/selectors.mdx → docs/docs/v1/walkthrough/selectors.mdx b/docs/docs/walkthrough/selectors.mdx → docs/docs/v1/walkthrough/selectors.mdx
diff --git a/docs/docs/walkthrough/side-effects.mdx → docs/docs/v1/walkthrough/side-effects.mdx b/docs/docs/walkthrough/side-effects.mdx → docs/docs/v1/walkthrough/side-effects.mdx
diff --git a/docs/docs/walkthrough/stores.mdx → docs/docs/v1/walkthrough/stores.mdx b/docs/docs/walkthrough/stores.mdx → docs/docs/v1/walkthrough/stores.mdx
diff --git a/docs/docs/walkthrough/suspense.mdx → docs/docs/v1/walkthrough/suspense.mdx b/docs/docs/walkthrough/suspense.mdx → docs/docs/v1/walkthrough/suspense.mdx
diff --git a/docs/docs/walkthrough/the-graph.mdx → docs/docs/v1/walkthrough/the-graph.mdx b/docs/docs/walkthrough/the-graph.mdx → docs/docs/v1/walkthrough/the-graph.mdx
diff --git a/docs/docs/v2/index.mdx b/docs/docs/v2/index.mdx
@@ -0,0 +1,20 @@
+---
+id: index
+title: v2 Documentation
+slug: /
+sidebar_label: Overview
+---
+
+# Zedux v2 Documentation
+
+Welcome to the v2 documentation. This section is being actively written as v2 PRs are merged.
+
+As docs are completed, they will appear in the sidebar on the left.
+
+## Looking for v1 Docs?
+
+The complete v1 documentation is available at [/docs/v1/walkthrough/quick-start](/docs/v1/walkthrough/quick-start).
+
+## Migration Guide
+
+If you're upgrading from v1 to v2, see the [Migration Guide](/docs/v1/migrations/v2).
diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js
@@ -62,7 +62,7 @@ module.exports = {
       },
       items: [
         {
-          to: 'docs/walkthrough/quick-start',
+          to: 'docs/v1/walkthrough/quick-start',
           activeBasePath: 'docs',
           label: 'Docs',
           position: 'left',
@@ -78,6 +78,10 @@ module.exports = {
           label: 'Blog',
           position: 'left',
         },
+        {
+          type: 'custom-versionSelector',
+          position: 'right',
+        },
         {
           href: 'https://github.com/Omnistac/zedux',
           label: 'GitHub',
@@ -97,11 +101,11 @@ module.exports = {
           items: [
             {
               label: 'Walkthrough',
-              to: 'docs/walkthrough/quick-start',
+              to: 'docs/v1/walkthrough/quick-start',
             },
             {
               label: 'API',
-              to: 'docs/api/api-overview',
+              to: 'docs/v1/api/api-overview',
             },
           ],
         },
@@ -131,15 +135,54 @@ module.exports = {
       copyright: `Copyright © 2017-${new Date().getFullYear()} Omnistac. Built with Docusaurus.`,
     },
   },
-  plugins: [PathsPlugin],
+  plugins: [
+    PathsPlugin,
+
+    // v1 docs (frozen)
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'v1',
+        path: 'docs/v1',
+        routeBasePath: 'docs/v1',
+        sidebarPath: require.resolve('./sidebars-v1.js'),
+        editUrl: 'https://github.com/Omnistac/zedux/edit/master/docs/docs/v1/',
+      },
+    ],
+
+    // v2 docs (current stable)
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'v2',
+        path: 'docs/v2',
+        routeBasePath: 'docs/v2',
+        sidebarPath: require.resolve('./sidebars-v2.js'),
+        editUrl: 'https://github.com/Omnistac/zedux/edit/master/docs/docs/v2/',
+      },
+    ],
+
+    // next docs (unreleased/development)
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'next',
+        path: 'docs/next',
+        routeBasePath: 'docs/next',
+        sidebarPath: require.resolve('./sidebars-next.js'),
+        editUrl: 'https://github.com/Omnistac/zedux/edit/master/docs/docs/next/',
+      },
+    ],
+
+    // Version resolver for unversioned /docs/... URLs
+    require.resolve('./plugins/docs-version-resolver'),
+  ],
   presets: [
     [
       '@docusaurus/preset-classic',
       {
-        docs: {
-          sidebarPath: require.resolve('./sidebars.js'),
-          editUrl: 'https://github.com/Omnistac/zedux/edit/master/docs/',
-        },
+        // Docs are handled by the plugins above
+        docs: false,
         theme: {
           customCss: require.resolve('./src/css/custom.css'),
         },

diff --git a/docs/plugins/docs-version-resolver.js b/docs/plugins/docs-version-resolver.js
@@ -0,0 +1,189 @@
+/**
+ * Docusaurus plugin for versioned documentation URL resolution
+ *
+ * This plugin creates routes for unversioned URLs (e.g., /docs/walkthrough/quick-start)
+ * that redirect to the appropriate versioned content based on:
+ * 1. Explicit redirects (for restructured content)
+ * 2. Current version's sidebar (if the doc is "ready")
+ * 3. Fallback to previous version with stale banner
+ */
+
+const { currentVersion, fallbackOrder, redirects } = require('../version-map')
+
+// Import all sidebars
+const sidebars = {
+  v1: require('../sidebars-v1'),
+  v2: require('../sidebars-v2'),
+  next: require('../sidebars-next'),
+}
+
+/**
+ * Recursively extract all doc paths from sidebar items
+ */
+function extractPaths(items) {
+  const paths = []
+  for (const item of items) {
+    if (typeof item === 'string') {
+      // Simple string reference: 'walkthrough/quick-start'
+      paths.push(item)
+    } else if (Array.isArray(item)) {
+      // Nested array - recurse into it
+      paths.push(...extractPaths(item))
+    } else if (item.type === 'category' && item.items) {
+      // Category with nested items: { type: 'category', label: '...', items: [...] }
+      paths.push(...extractPaths(item.items))
+    } else if (item.type === 'doc' && item.id) {
+      // Explicit doc reference: { type: 'doc', id: 'path' }
+      paths.push(item.id)
+    } else if (typeof item === 'object' && item !== null && !item.type) {
+      // Shorthand category: { Walkthrough: ['quick-start', ...] }
+      for (const value of Object.values(item)) {
+        if (Array.isArray(value)) {
+          paths.push(...extractPaths(value))
+        }
+      }
+    }
+    // Ignore 'link', 'html', 'ref', etc.
+  }
+  return paths
+}
+
+/**
+ * Extract all doc paths from a sidebar config
+ * Handles nested structures like { react: { About: [...], Walkthrough: [...] } }
+ */
+function extractSidebarPaths(sidebar) {
+  const allPaths = []
+
+  function processValue(value) {
+    if (Array.isArray(value)) {
+      // Array of items - extract doc paths
+      allPaths.push(...extractPaths(value))
+    } else if (typeof value === 'object' && value !== null) {
+      // Nested object like { About: [...], Walkthrough: [...] }
+      for (const nested of Object.values(value)) {
+        processValue(nested)
+      }
+    }
+  }
+
+  processValue(sidebar)
+  return new Set(allPaths)
+}
+
+// Pre-compute sidebar paths for each version
+const sidebarPaths = {
+  v1: extractSidebarPaths(sidebars.v1),
+  v2: extractSidebarPaths(sidebars.v2),
+  next: extractSidebarPaths(sidebars.next),
+}
+
+/**
+ * Determine which version a doc path should resolve to
+ */
+function resolveVersion(docPath) {
+  // 1. Check explicit redirects first (for restructured content)
+  if (redirects[docPath]?.[currentVersion]) {
+    return {
+      type: 'redirect',
+      to: redirects[docPath][currentVersion],
+    }
+  }
+
+  // 2. If it's in the current version's sidebar → use current (no banner)
+  if (sidebarPaths[currentVersion].has(docPath)) {
+    return {
+      type: 'current',
+      version: currentVersion,
+      path: `/docs/${currentVersion}/${docPath}`,
+    }
+  }
+
+  // 3. Fallback: find the latest version that has it in sidebar
+  for (const version of fallbackOrder) {
+    if (version !== currentVersion && sidebarPaths[version].has(docPath)) {
+      return {
+        type: 'stale',
+        version,
+        path: `/docs/${version}/${docPath}`,
+        currentVersion,
+      }
+    }
+  }
+
+  return { type: 'notfound' }
+}
+
+/**
+ * Docusaurus plugin entry point
+ */
+module.exports = function docsVersionResolver(context, options) {
+  return {
+    name: 'docs-version-resolver',
+
+    async contentLoaded({ actions }) {
+      const { addRoute, createData, setGlobalData } = actions
+
+      // Expose version data to client-side components (e.g., VersionSelector)
+      setGlobalData({
+        sidebarPaths: Object.fromEntries(
+          Object.entries(sidebarPaths).map(([v, paths]) => [v, [...paths]])
+        ),
+        redirects,
+        currentVersion,
+      })
+
+      // Collect all unique paths across all versions
+      const allPaths = new Set([
+        ...sidebarPaths.v1,
+        ...sidebarPaths.v2,
+        ...sidebarPaths.next,
+      ])
+
+      // Create a route for each path
+      for (const docPath of allPaths) {
+        const resolution = resolveVersion(docPath)
+
+        // Skip paths that don't resolve to anything
+        if (resolution.type === 'notfound') {
+          continue
+        }
+
+        // Create a data module with the resolution info
+        const dataPath = await createData(
+          `version-resolution-${docPath.replace(/\//g, '-')}.json`,
+          JSON.stringify(resolution)
+        )
+
+        // Add the unversioned route
+        addRoute({
+          path: `/docs/${docPath}`,
+          component: '@site/src/components/VersionedDocRedirect',
+          modules: {
+            resolution: dataPath,
+          },
+          exact: true,
+        })
+      }
+
+      // Also add a root /docs/ route that redirects to the current version
+      const rootResolution = await createData(
+        'version-resolution-root.json',
+        JSON.stringify({
+          type: 'current',
+          version: currentVersion,
+          path: `/docs/${currentVersion}/`,
+        })
+      )
+
+      addRoute({
+        path: '/docs',
+        component: '@site/src/components/VersionedDocRedirect',
+        modules: {
+          resolution: rootResolution,
+        },
+        exact: true,
+      })
+    },
+  }
+}
diff --git a/docs/sidebars-next.js b/docs/sidebars-next.js
@@ -0,0 +1,18 @@
+// next (development) sidebar - for unreleased docs
+//
+// Docs added here live in docs/docs/next/ and are served at /docs/next/
+// e.g. docs/docs/next/walkthrough/ecosystems.mdx → /docs/next/walkthrough/ecosystems
+//
+// To enable the "next" option in the version selector dropdown, uncomment
+// the entry in src/theme/NavbarItem/VersionSelector.tsx (not required).
+module.exports = {
+  react: [
+    'index', // Remove this once we add real docs
+    // Uncomment and populate sections as we write next docs:
+    // {
+    //   type: 'category',
+    //   label: 'About',
+    //   items: ['about/introduction'],
+    // },
+  ],
+}