ChoreoForge

Open ChoreoForge

Version 3

User Guide

Everything you need to know to plan, build, and export gymnastics routines with ChoreoForge.

1
Getting Started

Logging In

  1. Click Open ChoreoForge on the main menu
  2. If you are not already logged in, enter your username and password when prompted.
  3. Once logged in, the application loads automatically and you land on your personal Dashboard.

Your Subscription & Quota

  • The Quota Bar at the top of your Dashboard shows routines used vs. your limit and storage used vs. your limit.
  • If your subscription is close to expiring (within 7 days), an Expiry Banner appears at the top of the screen.
  • Routine saves are blocked when you reach your routine or storage limit.
2
The Dashboard

The Dashboard is your home screen. Every routine you have saved appears here as a card.

Dashboard Elements

  • Logo / Header — Shows the ChoreoForge logo, your name, and the main action buttons.
  • Quota Bar — Two progress bars (Routines and Storage) showing current usage vs. plan limits.
  • Expiry Banner — Appears when your subscription expires in 7 days or fewer.
  • Routines Grid — All your saved routines displayed as cards.
  • Empty State — Shown when you have no routines yet, with a prompt to create your first.

Header Buttons

  • + NEW ROUTINE — Opens the New Routine Wizard.
  • MANAGE TEAMS — Opens the Teams Manager.
  • MEDIA LIBRARY — Opens the Media Library (audio files & saved routines).

Routine Cards

Each card shows the routine name, gymnast count, formation count, total duration, and the date last saved.

  • OPEN — Loads the routine in the Editor.
  • DELETE — Permanently deletes the routine (you will be asked to confirm).
3
Managing Teams

Teams are saved groups of gymnasts. Create them once and reuse them across multiple routines.

Creating a Team

  1. Click MANAGE TEAMS on the Dashboard.
  2. Click + NEW TEAM.
  3. Enter a team name in the Team Name field.
  4. Add gymnasts using the Add gymnast field — type the name and press Enter or click ADD.
  5. Click DONE to save.

Assigning Gymnast Colours

  1. Open the Teams Manager and select a team from the list on the left.
  2. Click the coloured circle next to any gymnast’s name.
  3. Choose a colour in the colour picker, then close it.
  4. Click DONE to save.

Editing & Deleting

  • To remove a gymnast, click the ✕ button next to their name.
  • To delete an entire team, open the team and click DELETE TEAM at the bottom. This cannot be undone.
4
Media Library

The Media Library stores your audio files and saved routine files. Click MEDIA LIBRARY on the Dashboard to open it. The modal has two tabs:

  • Audio Files — All music tracks you have uploaded. Shows file name, size, and date.
  • Routines — All saved routines. Shows name, gymnast count, formation count, duration, and date.

Uploading Audio

  1. Open the Media Library and select the Audio Files tab.
  2. Click UPLOAD AUDIO and choose a file from your device.
  3. Wait for the progress indicator to finish — the file appears in the list when ready.

Deleting Files

Click DELETE next to any file or routine to permanently remove it.

5
Creating a New Routine

Click + NEW ROUTINE on the Dashboard to open the three-step wizard.

Step 1 — Name Your Routine

  1. Type a descriptive name in the Routine Name field (e.g., Spring Show 2025 — Senior Team).
  2. Click NEXT.

Step 2 — Select Team & Gymnasts

  1. Select a team from the dropdown. The gymnasts in that team appear as checkboxes.
  2. Tick the gymnasts who will perform. Use SELECT ALL or CLEAR as needed.
  3. Click NEXT.

Step 3 — Choose Your Music

  1. Pick an audio file already uploaded, or click UPLOAD AUDIO to add a new track.
  2. The selected file is highlighted — file name, size, and date are shown for reference.
  3. Click START EDITING to open the routine in the Editor.
6
The Editor

Editor Overview

  • Left Panel — Groups and Shapes controls.
  • Centre Panel — The floor canvas, the main editing area.
  • Right Panel — Timeline, Formations controls, and Gymnasts list.

Header Buttons

  • ← ROUTINES — Returns to the Dashboard. Unsaved changes will be lost — save first.
  • NEW — Starts the New Routine Wizard without leaving the Editor.
  • ▶ PLAY — Starts playback from the start of the routine.
  • ⏹ STOP — Stops playback and returns to the stopped state.
  • ANALYZE — Opens the Routine Analyzer.
  • SAVE — Saves the routine to your account.
  • ⏺ RECORD — Records a video of the routine playback.

The Floor Canvas

The floor is a 12 × 12 metre grid. The top edge is labelled BACK, the bottom FRONT / AUDIENCE. Axes are labelled 0–12 on both edges. Gymnasts appear as coloured circles.

  • Click a gymnast dot to select them.
  • Click empty floor space to move the selected gymnast there.
  • Hold Ctrl + click to select multiple gymnasts as shape targets.

Groups

Groups let you organise gymnasts into named sub-teams within a routine (e.g., “Acro Pair”). Once a group exists, clicking → SHAPE sets all its members as shape targets instantly.

  1. Click + ADD in the Groups section of the left panel.
  2. Enter a group name and click gymnast chips to toggle membership.
  3. Click SAVE.

Shapes

Shapes are pre-defined geometric patterns you can apply to any selection of gymnasts. ChoreoForge includes 8 built-in shapes:

━

Line

Spacing – Angle

○

Circle

Spacing – Rotation

∨

V Shape

Spacing – Angle

△

Triangle

Spacing – Angle

▦

Grid

Spacing

◇

Diamond

Spacing

□

Square

Spacing – Angle

⌢

Arc

Spacing – Angle
  1. Select target gymnasts — Ctrl+click on the canvas, or click → SHAPE on a Group to target all its members.
  2. Click a shape button in the left panel. A preview appears on the floor canvas as you drag the shape to the canvas.
  3. Adjust Spacing, Angle, or Rotation using the parameter inputs.
  4. Click PLACE SHAPE to confirm. Use ALL or CLEAR to manage targets.

Formations

A formation is a named snapshot of every gymnast’s floor position at a specific point in time. ChoreoForge animates the transitions between formations automatically.

  • Hold Time (s) — How long gymnasts stay in this formation before the next transition begins.
  • Transition Time (s) — How long gymnasts spend moving from this formation to the next.

Adding a Formation

  1. Position gymnasts on the floor as they should appear in this formation.
  2. Click the waveform or a time point in the Timeline to set the formation’s start time.
  3. Type a name in the Formation Name field (e.g., “Opening Diamond”).
  4. Set the Hold and Transition times.
  5. Click + ADD FORMATION.

Editing a Formation

  1. Click a formation block on the Timeline.
  2. Adjust gymnast positions and/or change the name and timing fields.
  3. Click UPDATE to save, or CANCEL to discard changes.

Deleting a Formation — Select the formation and click DELETE. This is immediate and cannot be undone.

The Timeline

  • ZOOM slider — Zooms the Timeline 1×–10× for precise timing control.
  • SCROLL slider — Scrolls the Timeline left or right when zoomed in.
  • Click on waveform — Jumps the playhead to that time position.
  • Drag formation block — Moves a formation to a different time position.
7
Playback & Recording

Playing Your Routine

  1. Click ▶ PLAY in the Editor header.
  2. Music starts and gymnasts animate between formations. The current formation name is displayed in the Formation Name field during playback.
  3. Click ⏹ STOP to halt at any time.

Recording a Video

ChoreoForge can capture the floor canvas and audio to a video file you can share with gymnasts, parents, or judges.

  1. Click ⏺ RECORD. Recording begins immediately.
  2. The routine plays from the beginning. Do not navigate away from the page while recording.
  3. When the routine ends (or you click STOP), recording stops and your browser downloads the video automatically.
  • Output format — WebM (plays in Chrome, Firefox, Edge)
  • Frame rate — 30 fps
  • Audio — Included if music is linked to the routine
8
Routine Analyzer

The Analyzer helps you check whether your routine is physically realistic by calculating how far each gymnast travels and flagging dangerously fast transitions.

  1. Click ANALYZE in the Editor header.
  2. Select the gymnasts you want to analyze from the list.
  3. The Analyzer draws movement paths as coloured lines and shows per-gymnast statistics.
  • Total movement — Total metres the gymnast travels across all formation transitions.
  • Fast transition warning — Shown when a gymnast moves more than 6 metres in a transition or the required speed exceeds a safe threshold. Shows a count of problematic transitions.
9
Saving Your Work

ChoreoForge saves routines to your account’s private cloud storage. Other coaches cannot see your routines.

  1. Click SAVE in the Editor header at any time.
  2. A status message confirms the save was successful.

If you reach your plan’s routine limit, saving will be blocked and an error message will appear. Free up a slot by deleting an old routine, or contact your administrator to upgrade your plan.

10
Plans & Limits

Your plan controls how many routines you can save and how much audio storage you have. Your current usage is always visible in the Quota Bar on the Dashboard.

Coach

  • 2 routines
  • 10 MB storage
  • All editor features
  • Playback & recording

Club

  • 10 routines
  • 70 MB storage
  • All editor features
  • Playback & recording
11
Tips & Shortcuts
  • Select multiple gymnasts for a shape — Hold Ctrl and click each gymnast dot on the canvas.
  • Select a whole group as shape targets — Click → SHAPE next to the group name.
  • Move a formation's start time — Drag the formation block left or right in the Timeline.
  • Zoom in on the Timeline — Drag the ZOOM slider to the right.
  • See which formation is active during playback — Watch the Formation Name field.
  • Access contextual help — Click the ⓘ icon in any panel section header.
  • Free up routine slots — Delete old routines from the Dashboard or Media Library.
  • Free up storage — Delete unused audio files (Media Library → Audio Files tab).
  • Reuse gymnasts across routines — Create a Team and select it each time you start a new routine.
  • Arrange a sub-team quickly — Create a Group, then use → SHAPE to target all its members at once.
12
Troubleshooting

Cause: You have reached your plan’s routine or storage limit.

Solution: Delete unused routines or audio files.

Cause: No music file is linked to the routine, the audio file was deleted, or browser autoplay is blocked.

Solution: Re-link an audio file via the routine wizard or Media Library. Allow autoplay in your browser settings for this site.

Cause: Browser screen capture was denied or is not supported.

Solution: Use Google Chrome and allow screen capture when prompted.

Cause: The routine has fewer than two formations, or all formations are at the same time position.

Solution: Ensure at least two formations exist at different time positions on the Timeline.

Cause: Multiple formations are close together in time.

Solution: Increase the Timeline zoom level using the ZOOM slider.

Cause: Your subscription expires within 7 days.

Solution: Renew your subscription from the Subscription page.

Cause: The page loaded before the plugin initialised, or a browser extension is interfering.

Solution: Hard-refresh the page (Ctrl+Shift+R on Windows). Try in a private/incognito window if the problem persists.