Skip to main content
Version: 5.10

Page Editor

FiestaBoard's WYSIWYG page editor lets you create and edit board display pages with a visual editor that shows exactly how content will appear on your split-flap display.

Overview

The page editor is the core of FiestaBoard's content creation experience. It provides a real-time preview of your board layout, template variable insertion, and color formatting, all in a visual interface.

Page Editor

Device Types

FiestaBoard supports multiple Vestaboard devices with different display sizes:

DeviceDimensionsTotal Characters
Flagship6 rows × 22 columns132
Note3 rows × 15 columns45

Pages are device-specific. The Pages section has Flagship and Note tabs to organize pages by device type. The editor and live preview automatically adapt to the selected device's dimensions.

tip

The Vestaboard Note supports a heart character (❤) at code 62, which displays as a degree symbol (°) on the Flagship.

Creating a New Page

  1. Open the FiestaBoard Web UI at http://localhost:4420
  2. Navigate to the Pages section
  3. Select the Flagship or Note tab for your target device
  4. Click New
  5. Give your page a name
  6. Use the editor to compose your content (dimensions match your target device)
  7. Click Save

Using Template Variables

Template variables let you insert live data from your enabled plugins into any page. Variables are automatically replaced with real-time data when the page is displayed.

Inserting Variables

  1. In the page editor, click the Variables button
  2. Browse available variables grouped by plugin
  3. Click a variable to insert it at the cursor position
Variable Picker dropdown showing available plugin variables

Variable Types

TypeDescriptionExample
SimpleSingle value replacement{weather.temperature}72°F
ArrayMulti-line data{stocks.prices} → formatted stock rows

Example Variables

Here are some commonly used template variables:

  • {weather.temperature} - Current temperature
  • {weather.condition} - Weather conditions (Sunny, Cloudy, etc.)
  • {stocks.prices} - Stock price display
  • {date_time.datetime} - Current date and time
  • {muni.formatted} - Transit arrival times

Inline Formulas ({{= ... }})

For anything beyond a plain value — IF / ELSE, comparisons, math, string manipulation, conditional colors — FiestaBoard supports an Excel-style formula language inside {{= ... }} blocks:

{{= IF(weather.temperature > 80, "HOT", "OK") }}
{{= IF(stocks.AAPL.change >= 0, COLOR("green"), COLOR("red")) }} AAPL

See the Template Formulas reference for the complete syntax, function list, and recipes.

AI Assistant (optional)

FiestaBoard includes FiestaBot, an AI chat assistant that can draft and edit board pages through natural conversation. Click AI Assistant in the sidebar (the Sparkles icon) to open the panel.

FiestaBot AI chat panel open alongside the page editor

FiestaBoard ships without any bundled LLM credentials. You bring your own provider, your own API key, and your own model list. Two wire-format protocols are supported out of the box:

  • OpenAI-compatible chat completions — works with OpenRouter, OpenAI, Groq, DeepSeek, Mistral, Together AI, Fireworks AI, Ollama, LM Studio, vLLM, llama.cpp, and most other local servers.
  • Anthropic Messages API — direct Claude access via api.anthropic.com.

How it works

  1. Click AI Assistant in the sidebar to open the FiestaBot panel.
  2. Type a description of what you want — for example, "Build a weather and transit page for my morning commute" or "Replace line 2 with today's date".
  3. FiestaBot edits your page in the editor directly. You can see each change applied in real time.
  4. Continue the conversation to refine the result, ask questions, or request a completely different layout.
  5. Click Save when you're happy — FiestaBot never saves a page without you confirming.

When a page is open in the editor, FiestaBot automatically has context of what you're working on — no need to attach anything manually. The panel is also available from any other section of the app, where it can answer questions about plugins, variables, and FiestaBoard features.

What FiestaBot can do

  • Create and edit pages — draft full template layouts or make targeted edits (change a line, add a variable, adjust alignment).
  • Suggest variables — recommend which plugin variables to use for a given goal and explain what they do.
  • Install plugins — recommend and install a plugin from the registry when it's needed for what you're building (requires your confirmation).
  • Configure settings — update display, polling, or silence schedule settings on your behalf (requires your confirmation).
  • Create and edit schedules and carousels — build automation around the pages you create (requires your confirmation).

Setup

The AI Assistant item only appears in the sidebar after you've configured at least one provider in Settings → AI Providers. See the AI Providers setup guide for the full walkthrough, recommended models, and a privacy note covering exactly what FiestaBoard sends to your provider.

Working with Colors

The split-flap display supports colored tiles using special character codes. You can use these in the editor to add visual emphasis to your pages.

Page editor showing color codes in use
CodeColorCommon Use
{63}🟥 RedAlerts, high temperatures
{64}🟧 OrangeWarm temperatures
{65}🟨 YellowComfortable, warnings
{66}🟩 GreenGood status, success
{67}🟦 BlueCold temperatures, info
{68}🟪 VioletVery cold, accents
{69}⬜ WhiteBackgrounds
{70}⬛ BlackBackgrounds

See the Color Guide for detailed usage examples.

Page Layout

The board display dimensions depend on the target device:

  • Flagship: 6 rows × 22 columns (132 characters)
  • Note: 3 rows × 15 columns (45 characters)

The editor reflects the target device's layout so you can see exactly how your content will be positioned.

Tips for Good Layouts

  • Keep text concise - You have limited characters per row (22 for Flagship, 15 for Note)
  • Use alignment - Center important information for readability
  • Mix data sources - Combine multiple plugin variables on one page
  • Test with preview - Use the live preview to check formatting before saving
  • Design per device - Create separate pages optimized for each device's dimensions

Managing Pages

Pages list view with Flagship and Note tabs

Editing Existing Pages

  1. Go to the Pages section
  2. Click on any page to open it in the editor
  3. Make your changes
  4. Click Save

Deleting Pages

  1. Go to the Pages section
  2. Click the delete option on the page you want to remove
  3. Confirm the deletion
tip

Pages that are referenced in schedules should be updated or removed from the schedule before deleting.

Next Steps