Save an event file for a lasting copy. The browser keeps a recovery draft on this computer, but that draft does not update your event file. Use Save or Save As… after making changes.
Open the app and learn the screen
Start Event Layout Manager
On Windows, launch the installed app from its Start menu or desktop shortcut. To run the project folder directly, install Node.js 22 or newer, run npm ci once in the folder, then double-click Start App.cmd. It starts the desktop app (the same as npm start) from a minimized console window. If Node.js or the installed packages are missing, or the app stops with an error, the launcher shows a message and waits for a key. Installed apps include their own runtime and do not need Node.js.
The installed and folder versions work offline. Your event files and recovery draft stay on this computer unless you save or copy them elsewhere. FTCLive import is an exception: it needs the FTCLive Scoring app running on the same computer. Use AI is optional and off until you turn it on; it lets an AI app on this computer, such as Claude or Codex, edit the open layout. That AI app uses your own AI account and its own internet connection (see Use AI).
For the browser edition from a project folder, run npm run start:browser, then open http://127.0.0.1:4174; leave its server running until you finish. A hosted copy opens from its supplied website address. Desktop and browser editions keep separate local drafts, as do different browsers or browser profiles. Move an .elm file between them when you want to continue the same event.
Know the main areas
Screen map, simplified. Numbers match the areas described below. Options starts closed. At narrow widths, Use AI and User Guide may appear as icons.
1–2 · Top bar: File contains layout actions. The header also shows the event title, the Fields, Tables, Booths, Chairs, and Teams counts, the Use AI button, the User Guide link, and a full-screen button.
2 · Options toolbar: choose Options in the top bar to open or close the layout tools: Room setup, Undo and Redo, Min table gap, Space table groups and Check spacing, Rulers and Ruler origin, Court, Grid, Snap, Align, zoom controls, Fit room, and the Light/Dark switch. The toolbar starts closed, and the app remembers whether you left it open.
3 · Left panel: choose the object to place, such as a competition field, table, booth, chair, label, or AV item. The catalog adds up to four columns as the sidebar widens, keeping tiles compact and labels readable. My elements and My Assemblies use matching tile sizes. Drag an item into the room. My elements, below the element tiles, holds elements you make from your own pictures. The Team List has its own entry in the Teams tools.
4 · Drawing surface: the grid represents the room in feet. Place and select objects here. Pan or zoom to work on a particular area.
5 · Element Options: the right panel edits selected objects. Its controls change with the current selection; fields that are mixed across multiple selected objects may show “Mixed.”
6 · Status and prompts: read the status message after an action. Dialogs may ask you to choose between saving, discarding, or canceling a change.
Dialogs center over the floor between Elements and Element Options and follow panel or window resizing. Large dialogs stay inside the window. At narrow window widths, setup dialogs and the roster list scroll inside the window. If labels or controls are crowded, maximize the app window or zoom the browser out slightly.
Start with these paths. Options opens a toolbar across the top; Elements, Tools and Teams are tabs in the left panel. The right panel changes when you select an object.
Choose New from File, then open Options → Room setup to choose a room preset or set a custom room size. Room dimensions are in feet.
Drag elements from the left-hand Elements panel onto the drawing. Choose the correct season-specific field. The playing square is 12 × 12 feet; BioBuzz includes alliance areas in a 21 × 12-foot floor footprint.
Click an element to select it. Drag it to move it, or press the arrow keys to nudge it. Edit its size (where the element allows it), angle, label, and colors in the options panel. Hold Shift while clicking to add or remove elements from a selection.
Element Options stays open on the right. Right-click an element for Copy, Paste, Duplicate, or Delete; use the right panel for property changes. Paste becomes available after you copy elements. After you press Enter in a box in the right panel, or click a number box’s arrows, the keyboard goes back to the drawing, so Ctrl+C and Ctrl+V copy and paste the selected elements.
Set the event title at the top, then save an event file before you finish.
The high-school, middle-school, and custom presets are starting points. You can change room dimensions, floor markings, and bleachers in Options → Room setup without clearing placed items.
New layouts start with the basketball court hidden. To show it, check Shadow basketball court in Room setup or Court in the Options toolbar; choosing a room preset does not turn it on. The high-school gym preset uses a centered 84 × 50-foot court and the middle-school preset a 74 × 42-foot court. A shaded, dashed band marks the 3-foot runoff around the playing area. Runoff follows the court when the room turns and remains attached to the selected court standard if you edit the room dimensions.
Where: top bar → Options → Room setup. Choose Options again to hide the toolbar without changing the room.
Room setup map, simplified. Select at the top; edit below. Save in this dialog applies pending edits to all rooms. File → Save saves the event to disk.
Choose the room, then edit its settings
In Rooms in this event, click a room’s name row. The highlight and — selected identify the room whose settings appear below.
In Selected room settings, enter its Room name, Room type, and measured dimensions. Length, left to right is horizontal; Width, top to bottom is vertical. Dimensions are in feet; border and bleacher row thicknesses use inches where labeled.
Set the floor color, optional basketball court, and bleachers. Each room keeps its own settings. Typing different gym dimensions preserves its gym type and court standard.
Click another room’s name to edit it, or choose Add room. A new room starts as Other / custom room; choose a gym type if needed. An event can contain up to 20 rooms.
Choose Save in Room setup to keep all pending room changes as one Undo step and close the dialog. This applies them to the open event; use File → Save to write the event file.
Close, the top-right ×, or Escape asks before discarding unsaved room changes. Choose Keep editing to return. The red boxed × beside a room asks before removing that room and its elements; choose Save to keep the removal. Keep a saved copy before removing a room you might need later.
Work in another room
When the event has several rooms, use the Room menu in the top-left of the drawing to choose the one to edit. Each room has its own floor and elements; the Team List belongs to the whole event. Switching rooms is undoable and clears temporary measurement rulers and ruler guides. Fit room brings the chosen room into view. Printing can cover the current room or all rooms.
Set court markings and room bleachers
The basketball court is a visual reference, not a competition field. New layouts keep it hidden. Turn on Shadow basketball court in Room setup, or Court in Options, to show it. Click a court line to edit its color and angle in Element Options.
Under Retractable bleachers, choose top/bottom or left/right walls and set each bank to No bleachers, Against wall, or Pulled out. Run is the length along the wall; Open depth is the space occupied when extended. Step and seat depth is one complete row, in inches. The extended depth adjusts to a whole number of rows. Click a bank on the drawing to extend or retract it. Turning off Show bleachers hides both banks while retaining their settings. Portable Bleacher elements are separate movable furniture.
Make a shaped floor
Select Other / custom room to see Floor outline. Choose Rectangle, L shape, T shape, Rounded rectangle / rink, or Custom outline. For the preset shapes, enter the dimensions in feet, choose Apply outline, review the floor, and choose Save in Room setup.
For a traced floor, choose Custom outline → Draw outline on floor. Click each corner on the drawing. You can draw beyond the existing room. Hold Shift to keep walls at 45° steps.
Watch the wall-length and inside-angle labels. Undo corner or Backspace removes the last corner. Escape cancels. Click the first corner again, or choose Close outline, to finish.
On the floor, drag corners or type wall lengths. The wall’s first corner stays fixed. Rectangles keep right angles; editing other polygons may change neighboring lengths and angles. Room dimensions follow the outline and their boxes become read-only.
Choose Done to return to Room setup, then Save. Use Edit outline on floor to revise it later.
The grid and court follow the usable floor. A footer warning counts items extending beyond it; those items are still editable. Changing the floor does not automatically rearrange furniture. Saved layouts and prints keep the outline.
When planning with an assistant, answer the missing questions a few at a time. Details already supplied should carry through every revision. Unknown measurements may use an explicitly agreed app preset for a provisional draft; the High School Gym preset is 100 × 102 feet. Confirm the actual venue before setup.
Event and season: what kind of event and robotics program is this? Which season or game applies? Should competition and practice use the same field configuration? Select the matching catalog field before planning its space: BioBuzz includes alliance areas in its 21 × 12-foot footprint.
Venue: confirm room type, dimensions, shape and additional rooms; entrance and exit positions and widths; bleacher location and extended depth; fixed obstacles, power and cable routes. Use the app preset when requested rather than substituting an outside estimate.
Teams and furniture: ask team or attendance count, whether team stations should be tables, booths or a mix based on the room. Confirm station counts and dimensions, chairs per table, furniture and chairs within each booth, and orient booth openings toward usable aisles; use the complete occupied footprint for spacing. Ask separately about scoring and registration table counts, sizes and chair counts, and which entrance registration should serve; a single number must not silently answer several questions. Confirm other requested areas and roster needs; FTCLive is an optional source of team data.
Fields and queues: confirm competition and practice field counts. For a robotics competition with bleachers, center the competition-field arrangement on the bleachers and face the audience. Keep the full field footprints at least eight feet from the extended bleachers. Confirm the clear gap between fields and keep it empty. Normally propose two queuing tables per competition field, then confirm table size, chairs and access routes. Locate practice fields centrally among the team pits.
Scoring: confirm whether tables should join end to end behind the fields. Provide the requested clear staff aisle behind the complete chair footprints; six feet is the working allowance in this example, not a universal venue measurement. Treat agreed table-end joins as intentional while preserving clearance around the combined row.
Projection: ask whether a projector and screen are needed and how many. One set is the usual proposal. Confirm placement, screen size and height, and the actual projector throw distance before setting the screen position. If the equipment details are unknown, identify the provisional throw distance explicitly rather than stretching the combo to fill empty floor space. Normally place the projector on the scoring table and center the screen and competition-field pair on the bleachers. Keep equipment out of the gap between competition fields. Preserve projector-and-screen combo linkage when a combo is used; do not silently split it into independent objects. A floor plan cannot establish spectator sightlines or beam clearance over people; verify those using actual equipment and heights.
Before placing objects, summarize the known counts, room preset, season, requested zones and assumptions. Ask table quantities separately from chairs, and clarify ambiguous answers before using them. Arrange the space for balanced use and direct access, then check full table-and-chair footprints, field and alliance-station clearances, queues, doors, bleachers, staff aisles and projection requirements. After every revision, check the earlier decisions together: centering the screen must not leave the fields or scoring row off-center. If the requested arrangement cannot fit, explain the conflict and offer specific alternatives.
Labels: follow the normal layout build rules. New elements keep their usual hidden object labels unless requested; preserve existing label visibility and styles. Use native team assignments for both tables and booths, with actual roster numbers rather than invented numbers or separate text labels. Successful assignment uses the normal Small Arial Black team-number style and shows team numbers; retain later hide or blank-placeholder choices until another assignment or display change. Keep visible labels readable and avoid unintended overlaps while retaining native attached team-label placement.
These are planning defaults for the relevant event type. The user's confirmed event requirements take precedence; confirm material unknowns instead of presenting assumptions as measured facts.
Save updates the event file you currently have open. The first Save for a new layout opens Save As… so you can choose its name and location; later Saves update that file. Save As… chooses a different file. New layout files use the .elm extension and contain JSON data. Existing .json layouts still open; when you save one, Event Layout Manager creates an .elm copy and leaves the original JSON file unchanged. In the desktop app, opening an .elm file from File → Open or from Explorer makes Save update that same file. In browsers, direct saving depends on file-system support; otherwise layouts download as .elm files.
The recovery draft is stored in this browser on this computer. It can help restore work after an interruption, but it is not a portable backup and is not a substitute for saving an event file. Keep a copy of important layouts somewhere you control.
File → New, Open…, and Close show the app’s Save, Don’t Save, or Cancel prompt when the current layout has unsaved changes. Saving must finish before the next layout opens; Cancel keeps your current work on screen. If you close the browser or app window with unsaved changes, your browser may instead show its own leave-page warning. Choose Stay to return to the editor and save the event file; choosing Leave closes the page.
To move a layout to another computer, transfer its .elm event file and open it from File → Open…. Older .json layout files can also be opened. Keep the original as a backup when opening a layout in older software. A layout file must be smaller than 16 MB and can hold up to 5,000 elements. Everything you can save opens again; Save tells you if a layout is too large to save.
Only one window edits at a time. If you open the app again while it is already open, the new window is read-only and says so; choose Edit here instead to move editing to it.
Choose the right kind of copy
What each file is for
Copy
Contains
Use it for
Event file (.elm)
The event’s rooms, placed elements and their pictures, roster and assignments
Continuing work or sharing an editable plan: File → Save / Save As…
PDF
The selected print pages
Distributing a plan to people who do not need to edit it: File → Print…
Team List CSV
The roster and close-to requests
Reusing team data: Teams → Team List → Export Team List (CSV)
My elements / My Assemblies JSON
The chosen local library
Moving reusable resources: Export… beside that library in Elements
Layout and settings backup
The recovery layout and editor preferences, theme and custom swatches
Moving or recovering local working state: File → Backup & Recovery
Move from browser to desktop
For the layout alone, save an .elm file in the browser, transfer it, and use File → Open… in the desktop app. For the working layout and settings, export layout and settings backup… in the browser, then import it through the same Backup & Recovery submenu on desktop. Review the replacement prompt. A successful import reloads the app and opens the transferred draft as unsaved; use Save As… to give it an event file. Export libraries separately if you also need unplaced My elements or My Assemblies.
Recovery copies and local data
File → Backup & Recovery → Recover drafts and local data… lists copies the app kept for you: a draft that could not be restored (for example one saved by a newer version), the draft before table combos were converted, and your data before a recovery bundle was imported. Export… saves a copy as a JSON file you can open; Delete removes it.
The app stores, on this computer only: the autosaved draft and its recovery copies, editor preferences, theme and custom colours (browser storage for this app), the libraries in My elements and My Assemblies, the files and save folder it remembers (browser file permissions, or the desktop app's profile folder), window position, and in the desktop app the Use AI setting and its connection token. Remove all local data… in the same dialog deletes all of it: AI connections are turned off, and AI apps you set up need the new token afterwards. Saved event files, including the custom elements placed in them, are not changed. Use it on shared or loaned laptops. The Windows browser version also keeps a log in %LOCALAPPDATA%\Event Layout Manager\logs (or the logs folder in an existing legacy profile), and the roster exporter writes an error log to %TEMP%\FTC-Roster-Exporter-error.log; delete those files to remove them.
Drag an item from the Elements panel into the room. Drag it again to move it. Drag on empty floor to select a region; hold Shift to add another region. Right-click an item for quick actions such as Copy, Duplicate and Delete; edit its properties in the right-hand Element Options panel. Select multiple items to move or rotate them as a group, or use Group to keep a set together.
To place a group, drag its Group button from the table tile onto the room floor. The table-count dialog opens when the drop reaches the floor; clicking the button shows a short hint. Keyboard users can focus Group and press Enter. Choose the count, then draw a box in an empty area. The group dialog uses the selected table size and the current Min table gap.
After a new table or drawn table group is placed, the Configure window asks whether to reserve it for team assignments and how many chairs to add per table. After Apply, the app adjusts the newly configured tables when needed to meet Min table gap, including their chairs, while keeping other elements in place. If it cannot find a fit, it keeps the table positions and shows red spacing marks. A team table is reserved for a team; you can assign its number from the Team List later. Choose Skip, press Escape, or close the window to keep the placement with its defaults. Undo reverses the setup answers and any automatic movement together; a second Undo removes the placement. Integrated-seating tables show their 12 fixed stools instead of an editable chair count.
Enable Snap to round movement to half-foot steps. Align can line item centers up with nearby items or the room center. Use the zoom controls or mouse wheel to zoom; use the middle mouse button to pan, and Fit room to bring the room into view.
Use Element Options for rotation, mirroring, grouping and duplication; use Options for Undo and Redo. A group rotates as one arrangement, so its spacing stays intact.
Select exactly what you need
One item: click it. A saved group selects together; Ungroup removes one grouping level.
Several items: Shift-click to add or remove items. Drag a rectangle on empty floor to enclose items; Shift-drag adds to the existing selection. Table selection follows the tabletop, so attached chairs or number labels may extend outside your box.
Overlapping or hard-to-find items: choose Elements → In use, expand the type, then click the specific item. Hover its list entry to highlight it on the floor.
A reusable group: select the items and choose Group in Element Options. Copy, Paste and Duplicate create independent copies, including independent groups.
Clear a selection: click empty floor or press Escape. Selecting alone does not change the saved layout.
Position and size: an item’s position is its center in feet. Width and depth belong to the item and rotate with it. Fixed catalog furniture retains its defined size; use a custom table or shape when a different size is required. Drag corner handles on resizable shapes; hold Shift to constrain square proportions. Use the rotation handle for a rigid selection turn, or type an angle in Element Options.
Zoom, pan and resize the panels
Use Options → − / + or the vertical mouse wheel to zoom. Middle-button drag pans. On a laptop, enable Scrollbars at the top-right of the drawing and use the horizontal and vertical scrollbars to pan; horizontal trackpad gestures also pan. Fit room restores a view of the whole room without moving any furniture.
Drag the vertical divider at either side of the drawing to widen the Elements/Teams panel or Element Options. You can focus a divider with Tab and use its arrow keys. Wider Elements panels show more catalog columns. Scroll inside each panel to reach controls below the fold; the full-screen button at the top-right gives the editor more room. The app remembers panel widths and view preferences.
Competition fields and venue elements
With several items selected, Rotate left/right asks how to rotate them. Choose Rotate individually to turn each item in place, or Rotate as a group to turn the entire arrangement together. Cancel keeps the layout unchanged. The rotation handle turns the selection together.
The top bar shows Fields, Tables, Booths, Chairs, and Teams. Teams counts all entries saved in the Team List, including teams that have not yet been assigned a table.
New installs start in Dark mode. Use Options to choose Light or Dark; the File menu follows your choice, which is remembered when you reopen the app.
After placing tables, you can change their seating later by selecting a table group and using Add Chairs to Tables in Element Options. Changing the chair count also adjusts the selected tables to Min table gap when possible, keeping other furniture in place. If they cannot fit, the chosen chairs remain and red marks show the spacing error. One Undo reverses the chair count and movement together. Enter the number of chairs per table; each table is limited to its own capacity. Mixed means the selected tables have different counts. One side only and Allow chairs on table ends apply to all selected rectangular tables. Other selected elements are unaffected.
Add 12 × 12 ft competition fields from the Competition section. The BIOBUZZ field is a separate game element and shows its field and alliance-area footprint. Use Tables, Chairs, Booth spaces, Doors, Arrows, Labels, and AV & Technology elements to plan check-in, pits, seating, and presentation areas. Single and double doors fill the area inside their swings with the floor color (white when the floor color is None). Select a door and choose Bring to Front to show an opening over walls or other elements; Send to Back restores the lower layer. A Booth space is 10 × 10 feet with its bottom edge open toward the aisle; rotate or mirror it to turn the opening. With Snap on, nearby booths snap edge to edge, which makes rows quick to build.
Queuing Tables places a red and a blue six-foot table in parallel with a four-foot clear gap. They are event queue furniture and cannot receive team assignments. Use ordinary eligible tables or booths for team stations.
For a projection setup, use Projector + screen to keep the screen, projector, and beam together. Adjust the screen width and projector distance in Element Options; the full beam angle updates automatically from those measurements. Screen color and thickness are adjustable independently, with thickness measured in inches. Optional 2-foot feet appear at the front and rear of the screen; you can show or hide them and change their length. A separate projector and screen are also available.
Click a bleacher bank in the room to retract or extend it. Ruler guides are temporary alignment aids; they are excluded from saved files and print/export output. Add persistent Measurement elements from the Elements tab; they show their dimension labels by default, and Show label hides them when needed.
Annotation adds a rounded text box with an arrow-tipped pointer. Drag a corner to resize the box; text wraps and grows or shrinks to use the available space. The Font menu lists fonts installed on this computer. Double-click the box to type and edit directly in it; Enter makes a new line, click elsewhere to save, or press Escape to cancel. Change text color, fill and stroke color in Element Options. Text box border width and Pointer thickness are independent; setting either to zero hides only that part. Drag the box to move it while the pointer tip stays fixed, or drag the blue target handle to point somewhere else without moving the box. Rotating or resizing the box keeps the pointer tip at its original target. Annotations support normal selection, grouping, duplication, Undo, printing and export.
Text adds a resizable label without a pointer. Its tile and new floor labels start with “Text”; saved label text stays as entered. Drag a corner to change its size; its text wraps and grows or shrinks to fill the box. Choose any font installed on this computer from the Font menu. Double-click the box to edit the text directly. Click elsewhere to save, or press Escape to cancel. Area Labels support normal selection, grouping, duplication, Undo, printing and export.
Under Elements, choose In use to browse the current room’s placed elements, sorted by type name. Each type starts collapsed; expand or collapse it to show its indented items. The list scrolls independently. Hover an item to highlight it on the floor, or click it to select that specific element and edit it in Element Options. Choose Add elements to return to the catalog.
Square / rectangle follows the 2-inch tape tile in Elements. Question Box starts with a transparent background, a bold 1.5-inch red border and a bold red question mark. New drops stay transparent even when an older room has a colored question-box default; existing boxes retain their chosen fill. Change its fill, border and text settings in Element Options.
Chairs start with a black back and a dark-gray seat halfway between black and the default table color. Chair fill and border/back colors remain editable.
The editing grid is never included in printouts, including multi-room prints and PDF output. Printing keeps the on-screen grid setting.
Measure, align, and turn the room
Tools, between Elements and Teams, contains Measure Distance. Select it, then drag in the room from one point to another to see the straight-line distance in feet and inches, rounded to the nearest inch. Each drag adds another ruler. Drag its yellow note to reposition it without changing the measured endpoints; a pointer connects the note to the measured distance. Close a ruler with its ×, or right-click it and choose Delete tape measure. Hold Shift while dragging to snap the angle to 22.5° steps. These rulers are temporary: they are not saved, printed, or exported. To keep a measurement in the layout, add the Measurement element from the Elements tab.
Drag from any of the four outer rulers into the room to make a temporary alignment guide. With Align on, element centers align to the guides. Guides are not saved, printed, or exported, and reloading clears them. Ruler origin in the Options toolbar chooses where ruler readings start: the center or any corner. It changes the readings only; nothing moves.
In Room setup, Room 90° turns the whole room and every element clockwise, and Undo reverses it. Show bleachers hides the bleacher banks without discarding their settings. In the Options toolbar, Space table groups lines the selected tables up in rows and columns, keeping at least the Min table gap between their full table-and-chair footprints, from other table groups, room walls and shown bleachers. Other objects must not overlap the tables. If it cannot keep those clearances, the action reports the conflict and leaves the layout unchanged. Undo restores the old arrangement.
Check spacing
Check spacing, next to Space table groups in the Options toolbar, measures the clear space between tables and round tables in the room you are editing, from edge to edge. A table and its chairs (attached, or grouped with it) count as one piece, so the space is measured from the chair edges. Booths are checked for actual overlap and room bounds, but booth-to-booth clear gaps are not checked because booth spaces commonly touch. Other furniture grouped with a table, such as a booth, is checked on its own. You do not need to select anything first.
Groups that are closer than Min table gap are outlined in red, with a dashed red line across the gap and the measured distance in feet.
Groups that overlap are outlined in red and labeled Overlap.
Tables, booths and their chairs that stand outside the room get a dashed red outline.
The status message sums it up, for example “All table groups are at least 3 ft apart.” In a very crowded room the check may stop early and say “at least” before a count; fix the marked tables and check again. Check spacing does not move anything: fix the marked tables yourself, or select them and use Space table groups. The red marks are temporary and are never saved, printed or exported. They disappear when you change the layout, press Escape, click empty floor, or click Check spacing again.
Check spacing measures; it does not approve a layout. The aisle widths, exits and accessibility an event needs come from the venue and local fire rules.
Colors
Element Options colors use swatches. Choose None (the slashed swatch) for a transparent fill or border, or the rainbow + swatch for a custom color: pick a shade and hue or type a six-digit hex value, then choose Apply Color, or Cancel to keep the existing color. Tables share one fill and border and chairs share another, so changing one table changes them all; check Use own table colors on a table that should differ. Other elements keep their own colors.
Most new elements start with their labels hidden. Select an element and turn on Show label to display its name. Labels always read the right way up: when you turn an element past a quarter turn or mirror it, its label turns with it so it is never upside down or backwards. Direction arrows have an Arrowheads at both ends option.
My elements, below the element tiles in the Elements panel, holds elements you make yourself, usually from a picture: a sponsor banner, a robot cart, a charging station or a venue feature. They are kept on this computer and can be placed in any layout.
Make an element
Open Tools and choose New Element… in the Create a new element section. Saved elements appear in My elements in the Elements panel.
Choose Choose image… and pick a PNG, JPEG, WebP, GIF, BMP or SVG picture of up to 15 MB, or leave the element as a plain colored shape. If the name is empty, the picture’s file name fills it in, and the depth follows the picture’s proportions until you type a size.
Enter a Name and choose a Shape: Rectangle, or Circle (an oval when the width and depth differ).
Set the Width and Depth in feet (0.1 to 500). This is the size each new copy starts with.
Choose the Image fit: Whole image shows all of the picture inside the shape; Fill the shape covers the shape and trims the edges of the picture that do not fit. The fill and border colors show around and behind the picture.
Check the preview, then choose Save to My elements.
The app keeps a small copy of the picture (at most 768 pixels on its longest side), so layouts stay small enough to save and share. An SVG drawing becomes a picture at that size.
Place and change your elements
Drag a My elements tile into the room, or click it and press Enter to place it in the middle of the view. A placed element moves, rotates, mirrors, groups, copies and prints like any other element, and you can change its size and colors in Element Options. Element Options also shows its shape and whether it is in My elements; Edit element… opens the element editor.
Each tile has a ⋯ button (or right-click the tile) with Edit… and, for elements in My elements, Delete from My elements…. Elements that are only in the open layout, for example from a layout someone sent you, show In this layout under their name; their menu offers Remove from this layout when none is placed.
My elements and your event files
Use Export… and Import… beside My elements to transfer the library, including pictures, between computers. Export suggests MyElements mm-dd-yy.json using today’s date. Import adds validated elements without changing the open layout or replacing existing elements; identical entries are skipped, and conflicting IDs are refused. My Assemblies export suggests MyAssemblies mm-dd-yy.json. Both libraries’ Import and Export dialogs open in the folder containing the current layout file, or the folder of the last layout you opened or saved if there is no current file. The app remembers that folder independently of the layout’s save target.
Placing an element copies it, picture included, into the layout. The saved event file therefore shows the element on any computer, without My elements. When you edit an element that the open layout also uses, leave Also update this element in the open layout checked to change it there too; other saved layouts keep their own copy. Before deleting an element from My elements, remove every placed copy from every room in the open layout. If a copy remains, an error explains what to remove. Once no copies are placed, one confirmed deletion removes the library entry and its unused definition in the open layout, so the tile disappears immediately. Other saved layouts keep their own copy.
A layout can use up to 60 different custom elements, and My elements keeps up to 100. If the pictures in a layout get too large together, the app asks you to use smaller pictures or fewer elements. Remove all local data… empties My elements but leaves your saved layouts alone. If the browser cannot store My elements, the New element window says so, and saved elements last only until the window closes.
When the layout has a different version
The layout can hold a different version of an element than My elements: you edited it without updating the layout, the layout came from another computer, or an AI changed it in the layout. The layout always shows its own version, and the app never swaps one version for the other without asking:
The tile shows Different in this layout under its name, and Element Options says Different from My elements.
The tile’s menu adds Edit this layout’s version…, which changes only the layout, and Use My elements version in this layout, which changes every placed copy to the My elements version. Undo reverses it.
When you place the tile, the app asks which version to use: Use My elements version (every placed copy changes too) or Keep this layout’s version.
Edit element… in Element Options edits the version placed in the layout. Edit… on the tile edits My elements; check Also use this version in the open layout to change the layout as well.
If a change cannot be used in the layout, for example because its pictures would be too large together, nothing is saved and the element editor says why.
Where: Tools → Create Assembly…; saved arrangements appear in Elements → My Assemblies, below My elements.
Arrange two or more elements on the floor, including their positions, rotations and labels. Select everything to include.
Open Tools → Create Assembly…, or right-click a selected element and choose Create Assembly….
Name the arrangement and choose Create Assembly.
In Elements, scroll to My Assemblies and drag its tile into any room or event.
An assembly is a reusable arrangement of ordinary elements; a custom element is one reusable object or picture. Group keeps objects together in the current drawing. Use an assembly when you want to reuse a registration desk, AV station or furniture arrangement in other layouts.
Double-click an assembly tile to rename it. Its × asks before deleting that saved assembly from this computer. Renaming or deleting the library entry does not remove furniture already placed in an event. Each placed assembly is an independent grouped copy; Ungroup lets you change its parts.
Export… and Import… next to My Assemblies transfer the local library, including custom-element definitions used by assemblies. Saved event files contain their placed elements, but do not transfer the rest of your assembly library. Export My elements and My Assemblies separately when moving your whole library to another computer.
Where: the Teams tab in the left panel. A roster entry, an eligible team station, and an assignment are three different things: importing names does not place furniture or assign teams.
Furniture, roster and assignments are separate. Put stations on the floor first; Apply saves the roster to the event before assignment buttons become available.
Place stations. Add tables or booths in Elements, including the chairs you need. For tables, choose their team status in the Configure dialog after placement.
Mark eligible stations. Select tables/booths and use Teams → Make selected tables/booths Team Tables/Booths, or check Team assignment just below the action buttons in Element Options. Newly placed booths are already eligible.
Add the roster. Open Team List, add or import teams, review them, and choose Apply. Assignment buttons stay disabled until the roster is applied.
Assign numbers. Choose manual assignment and drag available team cards onto stations, then Done; or choose automatic assignment, select row/column order, and Assign teams.
Review and save. Check labels, room assignments and any requested neighbors. Adjust Team # Style or the number display, then File → Save.
Special case: a folding table has two team spaces
The 12-foot folding table with integrated seating has 12 built-in stools, six along each long side. Its seating is fixed: chair count, ends, and one-side options are unavailable for that table. When it is selected with other tables, seating edits apply to the editable tables while its 12 stools remain unchanged. Built-in stools are excluded from the chair total. Table spacing measures from tabletop ends for end-to-end tables and from the outside seat edges for parallel tables. Mark it for Team assignment to use two 6-foot team spaces, one on each side of the fold. Drop a team onto the desired half, or use automatic assignment to fill both spaces. Each half has its own team number; moving the table moves both assignments together. Horizontal tables automatically leave a small gap between long team numbers without shrinking the text. Use the larger transparent perimeter around the table to move the furniture and both team numbers together; drag inside an individual number label to move that team independently. The table total counts one physical folding table.
Add the roster
Open Teams → Team List to add or edit teams. You can import an Excel workbook or a CSV, TSV, or text file. Columns A–C are Team#, TeamName, and School; column D can hold a “Wants to be close to team#” preference. Import replaces the roster and table assignments in the draft. Review the list and choose Apply to keep it; Cancel leaves the saved roster unchanged. Choose Export Team List (CSV) to save the current list, including unapplied edits, for the next competition. The suggested filename removes the open event file's .elm or .json extension, then appends “ Team List.csv” (for example, “Qualifier.elm” becomes “Qualifier Team List.csv”); with no open filename, it uses the event title. Export writes the Team#, TeamName, School, and close-to preference columns accepted by Import Teams; the save dialog uses the configured save folder, or the browser downloads the file.
For a direct connection, choose Import from FTCLive in Team List. Run FTCLive on this computer. Its public team report does not require a login (verified with T2). Use port 80 unless you changed it in FTCLive. Available events appear in an expanded list without pressing a down arrow. Refresh if needed, select a code and event name from the list (such as t2 — scrimmage 2), and load the teams, review the draft, then Apply to replace the saved roster and clear team assignments, or Cancel to keep the saved list. Team names come from the Competing Teams Report; School uses the school/community portion after the last & in its Affiliation. An unavailable event, empty roster, or connection error leaves the draft unchanged. This connection requires the local desktop app.
Team List groups Import Teams (Excel/CSV), Export Team List (CSV), Import Teams from FTCLive, Generate Fictional TEST Teams, and Delete all Teams together. To retrieve a roster on another Windows computer, open the separate retrieval card and choose Save FTCLive Exporter ZIP. Extract the ZIP on that computer and run Event Layout Manager Roster Exporter.cmd while FTCLive is running.
The CMD launcher opens the exporter, which lists available events and loads the selected event's teams. Choose another event if needed, then use Create Export File to save the CSV. If FTCLive starts later, the exporter retries automatically; Load events also refreshes the list. Bring the CSV back and choose Import Teams. Saving the ZIP does not require FTCLive and does not change this layout or its roster. In the browser, it downloads normally or uses your configured save folder; the desktop app opens a native save dialog.
Generate Fictional TEST Teams adds fictional demo entries to the draft. Choose how many to create, then Apply in Team List to keep them. You can remove them from the list later.
Prepare an import file
Use the first worksheet of an Excel workbook, or a comma-, tab- or semicolon-separated text file. A header row is optional; keep the columns in this order. The example below uses fictional teams.
Roster file example
A: Team#
B: TeamName
C: School
D: Wants to be close to team# (optional)
1234
Example Team A
Example School
5678
5678
Example Team B
Example School
Team numbers contain 1–9 digits and must be unique. Keep leading zeroes as text in a spreadsheet. Columns after D are ignored. Sort by Team # + School keeps school groups together and uses valid close-to requests to bring groups next to each other in the assignment order when possible. Sort by Team # uses number order instead. A request does not guarantee a particular physical distance; verify the final station locations yourself. Import replaces the draft roster and its assignments, so inspect it before Apply. Cancel preserves the roster and assignments already in the event.
Place a group of tables
Table tiles in Elements offer One and Group. Drag the tile or One button into the room to place one table. Drag Group onto the room floor, enter the number of tables in the dialog, then click Draw placement box and drag across an empty area of the room. The preview shows how the tables fit. Set Min table gap in Options at the top before starting; the grid keeps at least that much clear space between tables and may turn rectangular tables 90° to fit better.
The placed tables start as non-team tables and remain separate, ungrouped items. To designate them, check Team assignment in Element Options, or select them and press Make selected tables/booths Team Tables/Booths in Teams. Adding a team number to an ordinary table also makes it a Team Table. They are all selected immediately after placement; afterward, click any table to select and move it individually. They do not receive team numbers until you assign teams. Undo removes the whole placement in one step. If the area is too small, draw a larger box or cancel and reduce the count or gap. Existing elements stay in place; choose an empty area. Escape or Cancel exits without adding tables.
Place booth groups and furniture
Booth spaces offer One and Group, like tables. Drag Group onto the floor, choose the number of booths and a Row aisle width from 8 to 10 feet, then draw the placement area. Booths touch side by side. Check spacing does not flag booth-to-booth gaps, but still marks overlapping booth interiors and booths outside the room. The first two rows face each other across the chosen aisle; additional rows alternate touching back to back and facing across another aisle. Groups of two or more need room for at least one facing pair of rows. After dropping one or more booths, choose a 6-foot or 8-foot table, or no table, and set the total chair count in the configuration dialog.
Select one or more booths to edit their furniture in Element Options. Choose a 6-foot table, an 8-foot table, or no table, and set the total number of chairs. Mixed booth selections keep each booth’s table size when you change only the chair count. Existing furniture keeps its IDs, styles and custom labels when it can be retained; choosing no table removes the booth’s table and its owned chairs. Each booth and its furniture form a separate group, so they move and rotate together, and Undo restores furniture changes. The table sits at the back with no chairs at it. Chairs sit along the two side walls: four chairs give two on each side. The front stays open for the booth team number. Furniture stays inside the booth with at least a half-foot gap from the inner back and side wall strokes. The chair limit adjusts to the booth dimensions and table size. The booth catalog tile uses a table-colored filled preview for visibility. New booths on the floor have a transparent fill; an explicitly saved fill is preserved.
Portable Bleacher can be stretched to any length. Select it to change its length, number of rows and seat-front spacing in Element Options. It starts with four rows spaced 24 inches from the front of one row to the front of the next, and fills walkway spaces between seats with a shade of their color.
Room bleachers use 24-inch rows by default. In Room setup, change Step and seat depth to use another row depth; the extended bleacher depth adjusts to a whole number of rows. Each row is split evenly between the seat and walkway/step space, with one color for each half.
Mark and assign team tables
Use Tables or Booth spaces for team stations. Newly dropped booths, including groups, start marked for Team assignment and await a number from the Team List. Uncheck Team assignment in Element Options to use a booth without a team. A booth owns the team station number: assign a team to the booth. Its interior table is furniture and cannot be designated or assigned as another station; manually placed tables fully inside a booth are excluded too. Dragging a team number or roster card onto that table assigns the team to its booth. The default booth number is centered on the opening line between the two front wall tips, with half of its box inside and half outside the booth. Draw a box around independent tabletops to select tables; attached chairs and team-number labels may extend outside the selection box. Use Shift to extend the selection across groups, and click Make selected tables/booths Team Tables/Booths. Change an individual table’s or a selected group’s membership with the Team assignment checkbox directly below the Element Options action buttons. For a mixed selection, it changes only eligible tables/booths. Then assign roster entries manually by dragging a team card onto a table or booth, or use Assign Teams to Tables Automatically. The manual and automatic assignment buttons become available after teams have been added and applied in Team List. Automatic assignment follows the roster sort and the row or column order you choose.
Automatic assignment: the sorted Team List fills eligible stations starting at the top-left, by rows or columns. It replaces existing assignments on eligible stations and leaves the furniture in place; Undo restores the previous assignments. Review the sort menu before starting. Unfilled stations have no assigned-number label.
Assigned number labels stay with their table. On the 12-foot folding table, drag its larger transparent perimeter to move the furniture and both numbers together; drag inside either number label to move that team independently. On other tables, drag inside a number label to relocate that team, or drag the exposed table surface outside the label to move the furniture and keep its assignment. Returning a team to the list removes its table label, while leaving the table and chairs in place. The Team List shows all teams; the side-panel roster shows available teams while manual assignment is active. Click Done to finish manual assignment and keep the assigned labels.
Choose Team # Style to set the number size (X-Small through X-Large), font, colors, and label placement. The style applies to every room of the event. You can hide labels for printing or show blank labels for a hand-written check-in plan.
The number menu in Teams switches between Show Team Numbers, Hide Team Numbers, and Show Blank Placeholders; assignments are kept in every mode. Double-click a team number on a table to edit it (1 to 9 digits, leading zeroes kept): Enter saves and Escape cancels. Hover over an assigned table or booth to see its team name and school. Remove All Table and Booth Assignments asks you to confirm, returns every team to the list, and keeps the tables in place; Undo restores the assignments.
In the desktop app you can connect an AI app that you already use on this computer, such as Claude Desktop or the Codex app, and describe your event in your own words. The AI adds and arranges elements in the open layout while you watch, and you can stop it at any time. Event Layout Manager has no AI of its own and needs no account: the AI works through your own AI app and account. What the AI reads from your layout, such as element names, the Team List and preview pictures, becomes part of your conversation with that AI service.
The browser version and the web version show what Use AI does but cannot connect an AI; open your layout in the desktop app.
Turn on AI connections
Click Use AI in the top bar and turn on Allow AI connections. In a narrow window, Use AI shows only its sparkle icon.
Choose the AI app and use its setup action. For Codex, Connect or repair Codex sets up the connection automatically. Confirm if asked. The result appears directly below the button; when the settings are already correct, no confirmation is needed. Continue with the next step: in Codex open Settings → MCP servers → Restart. If your version has no Restart control, fully quit and reopen Codex.
Follow the selected app's numbered steps, start a new chat in that AI app and send the Test the connection prompt using Copy test prompt. It reads the layout title without changing anything. Return to Event Layout Manager and check for Connected. Neither app needs you to enter connection details. For Claude Code or another AI app, open Advanced → Other AI apps.
The Address and Token boxes hold what other AI apps need. The token works like a password for this app: give it only to AI apps on this computer. Show reveals it and Copy copies it. Once you have shown or copied the token or set up an AI app, the app keeps it, so AI apps you set up keep working after you restart.
Connect Claude Desktop
On the Claude Desktop tab, choose Save Claude Desktop extension… and save Event Layout Manager.mcpb to your Downloads folder.
Open the Downloads folder and drag Event Layout Manager.mcpb into Claude’s extension install window, then click Install. There is nothing to paste: the extension reads the connection token from Event Layout Manager on this computer.
With Allow AI connections on, start a new chat in Claude and use one of the example prompts in Use AI.
The extension file holds no token, and it keeps working after New token or a port change because it reads the app's current settings for each request. Keep Event Layout Manager open with AI connections on. Claude Code uses the copied setup command instead and needs an updated command after a token change. The Claude Desktop extension works on Windows and macOS. On Linux, use Codex or Claude Code.
Connect the Codex app
On the Codex app tab, choose Connect or repair Codex.
If asked, read the proposed settings change and choose Add. When settings already match, no confirmation is needed. Before changing the settings, Event Layout Manager saves a backup copy of Codex’s settings file next to it (named like config.toml.backup-20261022-153005), then adds an ftc-event-layout section with the address and token. Other Codex settings are not changed.
Follow the restart instructions shown in the Codex tab, start a new chat and send Copy test prompt first. After the connection test succeeds, use an example prompt or describe your event.
The section ends with default_tools_approval_mode = "approve". That line lets Codex change the layout without asking you before every edit; you still watch every change and can click Stop AI. Delete the line if you would rather approve each edit in Codex. The file is config.toml in the .codex folder of your user folder, and the Codex command line and editor extension read it too. Choosing Connect or repair Codex again refreshes only this section, so it is safe to repeat.
If Codex’s settings file has something Event Layout Manager cannot update safely, it changes nothing and says so. Then open Set up Codex by hand instead, choose Copy, open Settings › Configuration › Open config.toml in the Codex app, paste the lines at the end of the file, save it and restart Codex.
Connect Claude Code or another AI app
Open Other AI apps below the tabs and choose Copy command. Paste the command in a terminal and press Enter once. It looks like claude mcp add --scope user --transport http ftc-event-layout http://127.0.0.1:47615/mcp --header "Authorization: Bearer …" with your token at the end; --scope user makes it work in every folder. Then start Claude Code and ask it to use Event Layout Manager.
Another AI app can connect if it supports MCP over Streamable HTTP with a bearer token: give it the Address and the Token from Use AI.
Ask for a layout
The first example builds a BIOBUZZ layout with 30 team tables and four fields. Choose Copy to copy the complete request. You can ask the AI to turn the grid off when it finishes; this changes the view preference, independently of layout Undo.
Use AI lists example prompts with Copy buttons: a whole first event, fixing tight spacing, and assigning teams. For good results:
Save your layout first, or start from File → New, so you can always go back.
Give the facts: room size, where the doors, exits and power are, bleachers, how many teams and fields, and which areas you want (pits, queue, inspection, judging, audience, sponsors).
Give spacing in feet, such as “3 ft between pit tables and 6 ft walkways.”
Ask it to ask you questions first, then show a preview, check spacing, and finish.
Start with “Using the ftc-event-layout tools”, as the examples do, so the AI uses this app instead of trying a terminal or controlling your screen. If your AI app asks you to approve a tool, approve it. If you cancel one, nothing changed: approve it and ask the AI to continue.
To use a picture, give the full path of the file, such as C:\Users\Me\Pictures\sponsor-logo.png. The AI makes a custom element from it, which is also added to My elements. The AI never changes or deletes the elements you saved in My elements; if it changes one in your layout, only the layout’s version changes (see When the layout has a different version).
Check the result yourself. AI apps make mistakes, and the AI does not know your venue’s rules. Check spacing and Measure Distance help you check its work.
While the AI works
When the AI makes its first change, Event Layout Manager comes to the front and Use AI closes so you can watch the layout. The editor locks and a banner over the drawing says, for example, “Claude is editing your layout…”. The side panels, the File menu and the editing tools wait until it finishes. You can still zoom with the mouse wheel or the zoom buttons, pan with the middle mouse button, use Fit room, and open Use AI.
The lock ends when the AI says it has finished, or 2 minutes after its last request.
Stop AI, in the banner or in Use AI, ends the AI’s task at once and pauses it: the AI can still look at the layout but cannot change it until you click Let AI continue. The × on the paused message hides it.
After the AI finishes, one Ctrl + Z (⌘ + Z on macOS) undoes everything it did in that task, and Redo puts it back.
If you are busy, for example dragging an element, typing a value, working in another dialog, or opening or saving a file, the AI’s change is refused and the AI is asked to wait and try again.
While the AI is editing, New, Open…, Close, sample layouts and recovery bundle import wait too: the status message says so. Let the AI finish or click Stop AI first.
The AI works on the layout open in this window. It can also set up rooms, switch between them, fill in the Team List and assign teams. When it switches rooms, your temporary Measure Distance rulers and ruler guides are cleared, as when you switch rooms yourself.
Turning off Allow AI connections, New token or a new port cuts the AI off at once; a change it was still making is not applied.
The AI never opens, saves or deletes event files. Its changes mark the layout as unsaved and go into the recovery draft like your own edits; use Save when you are happy with them.
Keep the connection safe
Only programs on this computer can connect, and only with the token. Web pages cannot connect.
Turn off Allow AI connections when you are done; AI apps then cannot reach the layout.
New token replaces the token. The Claude Desktop extension picks up the new one by itself. The Codex app and other AI apps stop working until you give them the new one: Use AI reminds you to choose Connect or repair Codex again, and copy the Claude Code command again.
Advanced › Port changes the connection’s port. Change it only if another program already uses the port. The Claude Desktop extension follows by itself; choose Connect or repair Codex again and give other AI apps the new address.
To make a custom element, the AI can read a picture file that you point it to; it can read any picture you could open yourself. Point it only at pictures you are happy to put in the layout and to show the AI.
In the editor, choose File → Sample layouts… to pick one of the five supplied examples, or download one below. Their original layout data, teams and rooms are preserved. Every sample opens as a new, unsaved event; save your own copy before adapting it for an event.
Sample layouts are examples, not venue approval drawings. Check real room measurements, exits, accessibility, fire rules, and event requirements with the venue.
Where: File → Print…. On desktop, Ctrl+P (Command+P on macOS) opens the app’s print choices. In a browser, Ctrl+P uses native printing; open File → Print… when you need area, room or report choices.
Choose the pages you need
Print content choices
Button
Output
Layout · Landscape
The chosen room layout or selected rectangle
Team List
A separate report of the full event roster, ordered by number and by team name
Layout + Team List
Layout page(s), followed by the full event Team List on a new page
Choose Full layout, or select a rectangle. For a multi-room event, choose This room or All rooms (one page each). A selected rectangle always belongs to the current room.
Choose Scale to 1 Page for a fitted layout and a fitted roster. A single-room combined print uses two pages; all-room combined output adds a Team List page after the room pages. Choose Multiple pages when you want a long roster to keep a larger text size.
Select Letter or A4. Landscape orientation and narrow margins are prepared for you.
For full-layout prints, leave Include quantity summary checked to show nonzero counts of tables, booths, chairs and fields. Built-in stools on integrated-seating tables do not count as chairs. Cropped areas omit this summary.
Choose the content button, then review the print preview. On desktop the PDF preview opens in a separate window; use its print or save/download controls. In a browser use the printer destination or Save as PDF option provided by that browser. To put layout and roster on opposite sides of a sheet, enable two-sided / duplex in the printer settings.
Automatic full-layout crop: the current-room print fits around placed artwork, including rotated objects and labels; unused floor and room bleachers are omitted. An empty layout uses the room. All-room output fits each room with its elements. The grid, selection outlines, temporary rulers, ruler guides and red spacing marks are excluded. Persistent Measurement elements remain in the output.
These are fitted planning drawings. The screen zoom does not set a physical drawing scale on paper. Include persistent dimensions when a setup crew needs distances; check the preview after changing paper or printer scaling. Printing returns you to the same editor view and does not save the event file.
Print just part of a room
The dashed box is the crop, not an item selection. Edge objects are cut at the rectangle, as shown on the right. Screen zoom does not change what is included.
Switch to the room you want. Choose File → Print… → Select area….
The Print dialog closes and a drawing prompt appears. Drag from one corner of the wanted area to the opposite corner; either direction works. The blue dashed rectangle shows the area. Release to finish. A click without a rectangle keeps selection mode open.
The Print dialog returns with Selected area of this room checked and the rectangle’s size in feet. Choose Select area… again to redraw it, or Full layout to return to normal output.
Choose Layout or Layout + Team List, review the preview, and print or save the PDF.
Artwork crossing an edge is clipped exactly at the rectangle. All-room choices and quantity summaries are unavailable for crops. A combined report still contains the full event roster. Cancel or Escape while drawing abandons the new rectangle and returns to the choices. The crop is temporary and clears the next time you open Print.
Export editable data
Use File → Save As… for an editable .elm event file. Export a roster through Teams → Team List → Export Team List (CSV). Export libraries using Export… beside My elements or My Assemblies in Elements. Use File → Backup & Recovery for the layout and settings backup. See what each copy contains before moving to another computer.
Ctrl + P: Print choices on desktop; native print in the browser
Ctrl + O: Open
Ctrl + Z / Ctrl + Y: Undo / redo; Ctrl + Shift + Z also redoes
Ctrl + C / Ctrl + V: Copy / paste
Ctrl + D: Duplicate
Ctrl + G / Ctrl + Shift + G: Group / ungroup
Ctrl + A: Select all
Delete or Backspace: Remove the selection; Escape: Close a menu or clear the selection
In Elements, Enter on a card chooses it; Enter again places it in the middle of the view, ready to move with the arrow keys.
F2 (or Enter in the drawing): edit the selected team number in place
The Menu key or Shift + F10 in the drawing: open the selection's right-click menu
Arrow keys move the selection. With Snap on, each press moves 6 inches (0.5 foot). With Snap off, or when a selected element has snapping turned off, each press moves 0.1 foot (about 1 inch). Hold Shift to move 1 foot in either case.
When the cursor is inside a text or number box, typing and editing shortcuts apply to that box. Press Enter to finish a property edit, or click the drawing before using layout shortcuts. During a drag, Escape cancels the gesture; during area selection it returns to Print choices.
On macOS, the Command key works in place of Ctrl. Use the toolbar buttons and menus if your keyboard does not provide these keys. While an AI is editing the layout, these shortcuts wait until it finishes or you click Stop AI.
Confirm that you launched Start App.cmd from the Event Layout Manager folder, that Node.js 22 or newer is installed, and that you ran npm ci once in that folder. The launcher checks all three; if one is missing, or the app stops with an error, it prints what went wrong and waits for a key. Keep the folder together; do not move only the CMD file. To start the app again, run the command file again, or run npm start in the folder.
FTCLive import shows no events or cannot connect
Direct import works only in the local desktop app and only when FTCLive Scoring is running on this same computer. Start FTCLive Scoring, load the event there, then return to Team List and choose Refresh events. If the app says FTCLive Scoring is not loaded, open or load it first; an empty event list does not mean that teams were imported. Check the port in FTCLive if you changed it from port 80. The portable exporter follows the same local-FTCLive requirement.
If the direct connection is unavailable, use the portable exporter on the computer that runs FTCLive, create a CSV, transfer it to the Layout Manager computer, and import that CSV through Team List.
The AI can’t connect
Use the desktop app. The browser and web versions cannot connect an AI.
Keep Event Layout Manager open with your layout. Click Use AI and check that Allow AI connections is on. “Server ready. Follow the connection steps below in your AI app” confirms that Event Layout Manager is listening, but not that Codex loaded its settings. The Codex tab reports whether its config entry is missing, current or out of date; Connect or repair Codex refreshes it with the current address and token. When the AI app reports that Event Layout Manager is not running or AI connections are off, this is the step to check.
If the status line says the port is already in use, open Advanced, enter another port (for example 47616) and choose Apply. The Claude Desktop extension follows by itself; choose Connect or repair Codex again, or copy the new Claude Code command.
If Claude Desktop says that Event Layout Manager did not accept the connection token, or asks you for a token, the extension was saved by another copy or an earlier version of the app: choose Save Claude Desktop extension… again and install the new file.
If Codex or Claude Code says the token is wrong, choose Connect or repair Codex again, or copy the Claude Code command again. After New token or Remove all local data…, Codex and other AI apps need the new token.
For the Codex app, choose Connect or repair Codex: it refreshes the [mcp_servers.ftc-event-layout] section with the current address and token, including the line default_tools_approval_mode = "approve" that stops Codex asking before each change. Then in Codex open Settings → MCP servers → Restart, start a new chat and send the connection test prompt. If no Restart control is available, fully quit and reopen Codex. Event Layout Manager can confirm Codex connected only after Codex loads the settings and contacts it. If you set Codex up by hand and pasted the lines twice, keep only one copy.
If Claude or Codex does not list the ftc-event-layout tools, check that Allow AI connections is on, then restart the AI app (in Claude you can also turn the extension off and on in Settings › This computer › Extensions). For Codex, its settings check appears in the Codex tab; manually pasted setup and token details are under Advanced.
If the AI tries to use PowerShell, a terminal or screen control, stop it and ask again, starting with “Using the ftc-event-layout tools”. If your AI app says a tool call was cancelled, nothing changed: approve the ftc-event-layout tools and ask it to continue.
For Claude Code, the copied command uses --scope user, so it works in every folder. If it says the name already exists, run claude mcp remove ftc-event-layout first, then paste the command again.
After changing an AI app’s settings, close and reopen it or start a new chat or session.
If the AI says that AI editing is paused, click Let AI continue in the banner or in Use AI. If it says that you are busy, close any open dialog or file picker, finish typing or dragging, and ask it to try again.
My edits disappeared or I am unsure what was saved
Undo can reverse recent edits in the current session, and the browser recovery draft may help restore work after an interruption. Neither replaces an event file. Use Save and check the current file name shown by the app. For a separate checkpoint, choose Save As… and give the copy a new name. Before opening an important file in an older release, keep an untouched backup.
A layout opens differently in an older version
Newer releases can add saved layout features. This build saves format 40, including fixed non-team Queuing Tables. Builds supporting only format 39 or earlier cannot open format 40 layouts. Earlier versions use Arial for Area Label items. Annotation and Area Label text automatically grows or shrinks to fit the text box; double-click either box to edit the text in place. Event Layout Manager 1.2.0 to 1.3.4 save format 30 and cannot open newer layouts, and versions 1.1.0 and earlier do not read format 29 or newer. Open a layout in the same or a newer build than the one that saved it. Keep a backup before using any software that may convert or rewrite a file.
A control seems to be missing
Open Options to reveal room and view tools. Scroll inside the left or right panel, or drag its divider to widen it. Element Options only shows controls relevant to the selection. Team assignment requires an eligible table or booth; assignment buttons need a Team List saved with Apply. See the control finder.
I can’t move a table without moving its team number
Dragging inside an assigned number moves the team assignment. Drag the exposed table surface outside the label to move its furniture. On a 12-foot folding table, use the transparent outer perimeter to move the table and both assignments together. Use Elements → In use to select an item when overlapping labels make clicking difficult.
My table spacing changes after adding chairs
Spacing includes the chairs. Configure and Add Chairs to Tables may move the newly configured tables to meet Min table gap while keeping other objects fixed. If they cannot fit, the chosen seating stays and red marks show the problem. Review Options → Min table gap and Check spacing; Undo reverses seating and automatic movement together.
Team assignments are missing after import
Importing a replacement Team List clears assignments when you Apply it. Cancel before Apply to keep the saved roster; otherwise use Undo to restore the earlier event state. Apply the intended roster, mark the eligible stations and assign teams again.
Printing is clipped or too small
Choose File → Print…, inspect the preview, and select landscape orientation and a suitable paper size. Full-layout output fits around placed objects. To enlarge one part, select a print area. If something is cut off, redraw a larger rectangle or choose Full layout. Check Scale to 1 Page for a fitted report, or Multiple pages for a larger long roster. Choose the separate Team List or combined report when roster information is needed.
Where should I send feedback?
When reporting a problem, include the app version, the action you took, what you expected, and the message shown in the app. Use a copy of the layout with personal or event-sensitive details removed. Do not share the only copy of an important event file.