Skip to content

[DRAFT] docs: organize by runtime#537

Draft
lancesnider wants to merge 33 commits intomainfrom
organize-by-runtime
Draft

[DRAFT] docs: organize by runtime#537
lancesnider wants to merge 33 commits intomainfrom
organize-by-runtime

Conversation

@lancesnider
Copy link
Collaborator

@lancesnider lancesnider commented Mar 11, 2026

  • animation-control-and-interaction.mdx links to old landing pages
  • Create landing pages
  • Defold in new menu
  • Unreal in new menu
  • No Game Runtimes tab
  • Figure out which runtimes have Layout Bounds
  • Figure out runtime-specific SM controlling playback defaults and naming
  • Format - move and rename to .riv File format

This PR updates the structure of the runtime navigation. Instead of having runtimes/feature with all of the runtimes in tabs, we now have a separate page for each feature (runtimes/web/feature).

Navigation Changes

Main Tab Nav

CleanShot 2026-03-13 at 15 42 40
  1. Merged "Runtimes" and "Game runtimes" into "Implementing Rive". In an upcoming PR this will also include site builders and the Notion integration.
  2. Moved "Feature Support" to "Implementing Rive/Runtime Fundamentals" since it's runtime specific.
  3. Changed "Tutorials" to "Learn". This page is going to get a major revamp soooooon.

Sidebar Name Changes

  1. Renamed all the "Legacy" groups to "Legacy Features" for more clarity.
  2. Renamed "Format" to ".riv File Format" and took it out of "Advanced Features" since it was the only thing in there.
CleanShot 2026-03-13 at 15 44 21

Landing Pages

The top-level fundamentals pages no longer appear in the navigation, but we're keeping them around as landing pages. They're still relevant for cases when we need to link to a runtime feature, but don't know what runtime the user wants to use. For example, when linking from the editor pages.

Here's what each one looks like (you'll need to run this branch locally):

With demos:

CleanShot 2026-03-13 at 15 24 49

Without demos:

CleanShot 2026-03-13 at 15 00 26

For deprecated features:

CleanShot 2026-03-13 at 15 12 20

New Runtime Pages

The new runtime pages are a mix of snippets for shared content and runtime-specific examples.

If I made any content change, no matter how minor, I have included a before/after screenshot to make it easier to review. If a page doesn't include a comment, then the only change is that I got rid of the runtime tabs or the unrelated examples.

Legend

  • ✅ Done
  • ➖ Not applicable
Feature web react rn flutter apple android unity no inbound links redirect
✅ Artboards
✅ Layout
✅ State Machine
✅ Data Binding
✅ Loading Assets
✅ Fonts
✅ Caching
✅ Playing Audio
✅ Logging
✅ Animation Playback
✅ Inputs
✅ Text
✅ Rive Events
✅ Rendering to Bitmap

Runtime-specific Changes

Web

I removed the HTML from any example, keeping them purley JS:

CleanShot 2026-03-11 at 12 31 24

Unreal & Defold

No changes, expect menu location.

Unity

Most of the Unity changes were taking sentences that say "for more info see xyz" and replacing them with content. Sorry Adam, this is gonna be a pain to review! 😂

@lancesnider lancesnider requested a review from a team as a code owner March 11, 2026 19:00
@lancesnider lancesnider marked this pull request as draft March 11, 2026 19:00
---
title: 'Artboards'
description: 'Selecting which artboard to render at runtime'
---
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

@@ -0,0 +1,49 @@
---
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

import ReferencedAssets from "/snippets/runtimes/playing-audio/referenced-assets.mdx"

<Overview />

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

@@ -0,0 +1,64 @@
---
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

@@ -0,0 +1,19 @@
---
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

@@ -0,0 +1,19 @@
---
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

@@ -0,0 +1,19 @@
---
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

@@ -1,8 +1,10 @@
---
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

@@ -1,39 +1,20 @@
---
title: 'Rendering to a Bitmap'
description: 'Render screenshots and video at runtime.'
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

@@ -0,0 +1,32 @@
---
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

@@ -0,0 +1,14 @@
---
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

@@ -0,0 +1,74 @@
---
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

@@ -0,0 +1,147 @@
---
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant