From fd9597630e8ec88b518499ae216fd934554724f9 Mon Sep 17 00:00:00 2001 From: Lance Date: Thu, 3 Sep 2026 11:29:14 +0200 Subject: [PATCH 01/11] quick start first draft --- editor/quick-start/overview.mdx | 111 ++++++++++++++++++++++++++++++++ 1 file changed, 111 insertions(+) create mode 100644 editor/quick-start/overview.mdx diff --git a/editor/quick-start/overview.mdx b/editor/quick-start/overview.mdx new file mode 100644 index 00000000..2dd84241 --- /dev/null +++ b/editor/quick-start/overview.mdx @@ -0,0 +1,111 @@ +--- +title: "Quick Start" +description: "Learn the core Rive workflow, from building and animating content to adding interaction, data, scripting, and publishing." +--- + +Rive lets you design, animate, and make interactive graphics in a single tool, then control them with data or code at runtime. + +This quick start walks through the core workflow at a high level. You don't need to learn every feature before you begin. Use this page to understand how the major parts of Rive fit together, then follow the links to explore each area in more detail. + +## Build it + +Start by creating the visual structure of your Rive file. + +An **artboard** is the main container for your design. Artboards can contain shapes, text, images, components, and other objects. + +Use Rive's design tools to create and arrange content directly in the editor. You can draw vector paths, create procedural shapes, add text, align and distribute objects, and organize your file with groups and components. + +**Components** let you create reusable pieces of a design. When you update the source component, its instances update with it. + +Rive also supports responsive design. Use **Layouts** to control how content sizes, positions, and responds when its available space changes. + +You can also bring external assets into your file, including fonts, vector graphics, raster images, and audio. + +Learn more: + +- [Artboards](/editor/fundamentals/artboards) +- [Components](/editor/fundamentals/components) +- [Drawing](/editor/design) +- [Text](/editor/text) +- [Layouts](/editor/layouts) +- [Assets](/editor/assets) + +## Animate it + +Once you've built your design, bring it to life with animation. + +Animations in Rive are created on a **timeline**. Add keys to properties such as position, rotation, scale, color, opacity, and other values, then control how Rive interpolates between them. + +A single file can contain multiple animations, from simple transitions to complex character animation. + +Learn more: + +- [Animation](/editor/animate-mode) +- [Keys](/editor/animate-mode/keys) +- [Interpolation](/editor/animate-mode/interpolation) + +## Make it interactive + +Animations play in a predetermined sequence. **State machines** let your animation respond to input and change over time. + +A state machine connects animations and other states with transitions. Conditions determine when Rive moves from one state to another. + +Use multiple **layers** when different parts of an interaction need to operate independently or at the same time. + +You can also use listeners to respond to pointer interactions, Rive events, and other changes inside your file. + +Learn more: + +- [State Machines](/editor/state-machine) +- [State Machine Layers](/editor/state-machine/layers) +- [Listeners](/editor/listeners) + +## Control it with data + +Use **data binding** when your Rive content needs to display or respond to dynamic information. + +A **view model** defines the data your Rive file can work with. Its properties can store values such as numbers, strings, booleans, colors, images, enums, and other data. + +Bind those properties to objects and behavior throughout your file. For example, data can control text, colors, transforms, animation speeds, state machine behavior, or which content is displayed. + +At runtime, your application can update the same data without needing to know how the underlying animation is constructed. + +Learn more: + +- [View Models](/editor/data-binding/view-models) +- [Data Binding](/editor/data-binding) +- [Properties](/editor/data-binding/property-types) + +## Script it + +For behavior that goes beyond the built-in editor tools, you can extend Rive with scripting. + +Scripts can create custom behavior, generate graphics, transform data, define transition logic, and interact with other parts of a Rive file. + +You don't need scripting for most Rive projects. Add it when the behavior you need is easier to express with code. + +Learn more: + +- [Scripting](/scripting) +- [Getting Started with Scripting](/scripting/getting-started) + +## Publish it anywhere + +When your Rive file is ready, publish it for use outside the editor. + +Rive runtimes let you render and control your content in applications across web, mobile, game engines, and other platforms. + +At runtime, you can play animations, control state machines, update bound data, respond to events, and integrate Rive with the rest of your application. + +Learn more: + +- [Publishing](/editor/publishing) +- [Runtimes](/runtimes) + +## Where to go next + +You now have the basic Rive workflow: + +**Build it → Animate it → Make it interactive → Control it with data → Script it → Publish it anywhere** + +You don't need to follow that sequence for every project. Once you're familiar with the workflow, use the Editor documentation as a reference and jump directly to the feature you need. From fa375a68d73f9acc7b865faca58b546fdd362dc8 Mon Sep 17 00:00:00 2001 From: Lance Date: Thu, 3 Sep 2026 11:30:25 +0200 Subject: [PATCH 02/11] remove legacy features from sidebar we don't want to drive people here - search is fine --- docs.json | 7 ------- 1 file changed, 7 deletions(-) diff --git a/docs.json b/docs.json index f5fe1d71..268dc23d 100644 --- a/docs.json +++ b/docs.json @@ -276,13 +276,6 @@ }, "account-admin/bring-your-own-bucket" ] - }, - { - "group": "Legacy Features", - "pages": [ - "editor/state-machine/inputs", - "editor/events/general-events" - ] } ] } From ba40a1f1f68b575d4cd99cb75b72316b267ec8c6 Mon Sep 17 00:00:00 2001 From: Lance Date: Thu, 3 Sep 2026 11:31:23 +0200 Subject: [PATCH 03/11] move workspaces to support along with other admin content move workspaces to support along with other admin content --- docs.json | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs.json b/docs.json index 268dc23d..5009f242 100644 --- a/docs.json +++ b/docs.json @@ -266,14 +266,6 @@ { "group": "Admin & Workspaces", "pages": [ - { - "group": "Workspaces", - "pages": [ - "account-admin/workspaces/workspaces-overview", - "account-admin/workspaces/managing-workspaces", - "account-admin/workspaces/managing-workspace-members" - ] - }, "account-admin/bring-your-own-bucket" ] } @@ -869,6 +861,14 @@ "account-admin/account-overview/delete-my-account", "account-admin/workspaces/reactivating-a-canceled-workspace" ] + }, + { + "group": "Workspaces", + "pages": [ + "account-admin/workspaces/workspaces-overview", + "account-admin/workspaces/managing-workspaces", + "account-admin/workspaces/managing-workspace-members" + ] } ] } From 69253cde945899ec2a19508995236e7f952d7f9d Mon Sep 17 00:00:00 2001 From: Lance Date: Thu, 3 Sep 2026 11:34:50 +0200 Subject: [PATCH 04/11] move byo bucket to support --- docs.json | 9 ++------- 1 file changed, 2 insertions(+), 7 deletions(-) diff --git a/docs.json b/docs.json index 5009f242..707e023a 100644 --- a/docs.json +++ b/docs.json @@ -262,12 +262,6 @@ "editor/accessibility/semantics", "editor/accessibility/reduced-motion" ] - }, - { - "group": "Admin & Workspaces", - "pages": [ - "account-admin/bring-your-own-bucket" - ] } ] } @@ -869,7 +863,8 @@ "account-admin/workspaces/managing-workspaces", "account-admin/workspaces/managing-workspace-members" ] - } + }, + "account-admin/bring-your-own-bucket" ] } ] From 71b763b7bd8787048ee63ea9559abba7bc14f176 Mon Sep 17 00:00:00 2001 From: Lance Date: Thu, 3 Sep 2026 11:36:09 +0200 Subject: [PATCH 05/11] move rigging and control to main sidebar --- docs.json | 46 +++++++++++++++++++++++----------------------- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/docs.json b/docs.json index 707e023a..01c8ee93 100644 --- a/docs.json +++ b/docs.json @@ -168,6 +168,29 @@ "editor/animate-mode/interpolation-easing" ] }, + { + "group": "Rigging & Control", + "pages": [ + "editor/manipulating-shapes/manipulating-shapes", + "editor/manipulating-shapes/meshes", + "editor/manipulating-shapes/bones", + "editor/manipulating-shapes/joysticks", + { + "group": "Constraints", + "pages": [ + "editor/constraints/constraints-overview", + "editor/constraints/ik-constraint", + "editor/constraints/distance-constraint", + "editor/constraints/scale-constraint", + "editor/constraints/rotation-constraint", + "editor/constraints/transform-constraint", + "editor/constraints/translation-constraint", + "editor/constraints/follow-path-constraint", + "editor/constraints/scroll-constraint" + ] + } + ] + }, { "group": "Interaction", "pages": [ @@ -233,29 +256,6 @@ "editor/ai/mcp" ] }, - { - "group": "Rigging & Control", - "pages": [ - "editor/manipulating-shapes/manipulating-shapes", - "editor/manipulating-shapes/meshes", - "editor/manipulating-shapes/bones", - "editor/manipulating-shapes/joysticks", - { - "group": "Constraints", - "pages": [ - "editor/constraints/constraints-overview", - "editor/constraints/ik-constraint", - "editor/constraints/distance-constraint", - "editor/constraints/scale-constraint", - "editor/constraints/rotation-constraint", - "editor/constraints/transform-constraint", - "editor/constraints/translation-constraint", - "editor/constraints/follow-path-constraint", - "editor/constraints/scroll-constraint" - ] - } - ] - }, { "group": "Accessibility", "pages": [ From a93d5c952f45e113eced53d367c75bc46c5eb3c8 Mon Sep 17 00:00:00 2001 From: Lance Date: Thu, 3 Sep 2026 11:36:53 +0200 Subject: [PATCH 06/11] move ai to main sidebar --- docs.json | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs.json b/docs.json index 01c8ee93..72102255 100644 --- a/docs.json +++ b/docs.json @@ -243,19 +243,19 @@ "editor/exporting/exporting-for-video-and-static-design", "editor/exporting/exporting-for-backup" ] - } - ] - }, - { - "group": "Advanced Topics", - "pages": [ + }, { "group": "AI", "pages": [ "editor/ai-agent/ai-agent", "editor/ai/mcp" ] - }, + } + ] + }, + { + "group": "Advanced Topics", + "pages": [ { "group": "Accessibility", "pages": [ From cb543c9ffc07bb57d48c0e41930dbfafcf0685f4 Mon Sep 17 00:00:00 2001 From: Lance Date: Thu, 3 Sep 2026 11:39:40 +0200 Subject: [PATCH 07/11] move accessibiltiy to main nav --- docs.json | 19 +++++++------------ 1 file changed, 7 insertions(+), 12 deletions(-) diff --git a/docs.json b/docs.json index 72102255..9ed880aa 100644 --- a/docs.json +++ b/docs.json @@ -235,6 +235,13 @@ } ] }, + { + "group": "Accessibility", + "pages": [ + "editor/accessibility/semantics", + "editor/accessibility/reduced-motion" + ] + }, { "group": "Publishing", "pages": [ @@ -252,18 +259,6 @@ ] } ] - }, - { - "group": "Advanced Topics", - "pages": [ - { - "group": "Accessibility", - "pages": [ - "editor/accessibility/semantics", - "editor/accessibility/reduced-motion" - ] - } - ] } ] }, From c01e547a97a8a3ccbc03e8612fa8d635cbb9c59e Mon Sep 17 00:00:00 2001 From: Lance Date: Thu, 3 Sep 2026 12:33:04 +0200 Subject: [PATCH 08/11] move workflows --- docs.json | 47 ++++++++++++++++++------------ getting-started/best-practices.mdx | 2 +- 2 files changed, 30 insertions(+), 19 deletions(-) diff --git a/docs.json b/docs.json index 9ed880aa..b42bb02c 100644 --- a/docs.json +++ b/docs.json @@ -67,6 +67,7 @@ "group": " ", "pages": [ "editor/get-rive", + "editor/quick-start/overview", { "group": "Editor Interface", "pages": [ @@ -76,18 +77,9 @@ "editor/interface-overview/toolbar", "editor/interface-overview/sidebar", "editor/interface-overview/inspector", - "editor/interface-overview/debug-panel" - ] - }, - { - "group": "Workflows", - "pages": [ + "editor/interface-overview/debug-panel", "editor/interface-overview/selection-and-navigation", - "editor/keyboard-shortcuts", - "editor/workflows/dependency-graph", - "editor/tagging", - "editor/fundamentals/revision-history", - "getting-started/best-practices" + "editor/keyboard-shortcuts" ] } ] @@ -235,13 +227,6 @@ } ] }, - { - "group": "Accessibility", - "pages": [ - "editor/accessibility/semantics", - "editor/accessibility/reduced-motion" - ] - }, { "group": "Publishing", "pages": [ @@ -259,6 +244,32 @@ ] } ] + }, + { + "group": "Workflows", + "pages": [ + { + "group": "Best Practices", + "pages": [ + "getting-started/best-practices", + { + "group": "Accessibility", + "pages": [ + "editor/accessibility/semantics", + "editor/accessibility/reduced-motion" + ] + } + ] + }, + { + "group": "File Management", + "pages": [ + "editor/workflows/dependency-graph", + "editor/tagging", + "editor/fundamentals/revision-history" + ] + } + ] } ] }, diff --git a/getting-started/best-practices.mdx b/getting-started/best-practices.mdx index e616b05c..c917bd42 100644 --- a/getting-started/best-practices.mdx +++ b/getting-started/best-practices.mdx @@ -1,5 +1,5 @@ --- -title: "Best Practices" +title: "Performance" description: "Editor & runtime performance and usage considerations." --- From 676415ba272367f4e008f593c71e6143e604acff Mon Sep 17 00:00:00 2001 From: Lance Date: Wed, 9 Sep 2026 11:31:48 -0700 Subject: [PATCH 09/11] move accessibility to fundimentals --- docs.json | 21 ++++++++------------- 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/docs.json b/docs.json index 32a6a8b5..399b2a81 100644 --- a/docs.json +++ b/docs.json @@ -236,6 +236,13 @@ "editor/exporting/exporting-for-backup" ] }, + { + "group": "Accessibility", + "pages": [ + "editor/accessibility/semantics", + "editor/accessibility/reduced-motion" + ] + }, { "group": "AI", "pages": [ @@ -248,19 +255,7 @@ { "group": "Workflows", "pages": [ - { - "group": "Best Practices", - "pages": [ - "getting-started/best-practices", - { - "group": "Accessibility", - "pages": [ - "editor/accessibility/semantics", - "editor/accessibility/reduced-motion" - ] - } - ] - }, + "getting-started/best-practices", { "group": "File Management", "pages": [ From b51e4cb414bcc74444ec71e527de2092d824ce31 Mon Sep 17 00:00:00 2001 From: Lance Date: Wed, 9 Sep 2026 11:34:32 -0700 Subject: [PATCH 10/11] move file management links --- docs.json | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/docs.json b/docs.json index 399b2a81..4fea7bd6 100644 --- a/docs.json +++ b/docs.json @@ -123,7 +123,8 @@ "editor/manipulating-shapes/solos", "editor/fundamentals/transform-spaces", "editor/fundamentals/freeze-and-origin", - "editor/animate-mode/animating-draw-order" + "editor/animate-mode/animating-draw-order", + "editor/tagging" ] }, { @@ -256,14 +257,8 @@ "group": "Workflows", "pages": [ "getting-started/best-practices", - { - "group": "File Management", - "pages": [ - "editor/workflows/dependency-graph", - "editor/tagging", - "editor/fundamentals/revision-history" - ] - } + "editor/workflows/dependency-graph", + "editor/fundamentals/revision-history" ] } ] From e28ae62673658f7ab198e51a66299084fe00be71 Mon Sep 17 00:00:00 2001 From: Lance Date: Wed, 9 Sep 2026 16:48:12 -0700 Subject: [PATCH 11/11] link rot --- editor/quick-start/overview.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/editor/quick-start/overview.mdx b/editor/quick-start/overview.mdx index 2dd84241..06194cfa 100644 --- a/editor/quick-start/overview.mdx +++ b/editor/quick-start/overview.mdx @@ -42,7 +42,7 @@ Learn more: - [Animation](/editor/animate-mode) - [Keys](/editor/animate-mode/keys) -- [Interpolation](/editor/animate-mode/interpolation) +- [Interpolation](/editor/animate-mode/interpolation-easing) ## Make it interactive @@ -58,7 +58,7 @@ Learn more: - [State Machines](/editor/state-machine) - [State Machine Layers](/editor/state-machine/layers) -- [Listeners](/editor/listeners) +- [Listeners](/editor/state-machine/listeners) ## Control it with data @@ -99,7 +99,7 @@ At runtime, you can play animations, control state machines, update bound data, Learn more: -- [Publishing](/editor/publishing) +- [Publishing](/editor/exporting/exporting-for-runtime) - [Runtimes](/runtimes) ## Where to go next