> For the complete documentation index, see [llms.txt](https://swu-forge.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://swu-forge.gitbook.io/docs/decks/workshop.md). # The Workshop The **Workshop** (`/workshop`) is your visual deck editor. Unlike the browse page where search is the main focus, the workshop puts your **deck front and center** with search as a complementary tool for finding specific cards. You reach it from wherever you're working on a deck: **+ New Deck → Build from Scratch**, **Edit Deck** on any deck card or deck page, or the **Workshop** button in the Browse page's deck panel. ## Layout Overview The workshop uses a **2-column layout** on desktop: | Left Column | Right Column | | ------------------------------------------------------- | ---------------------------------------------------------------------------------- | | **Your Deck** — Leader, Base, main deck grid, sideboard | **Search & Filters** — Format toggle, search bar, filter dropdowns, search results | On mobile, the search column becomes a **slide-in drawer** accessible via the search tab button. ![Screenshot: Workshop 2-column layout](https://cdn.swuforge.com/how-tos/workshop-layout.png) ## Your Deck (Left Column) ### Leader & Base Slots At the top, two slots show your Leader and Base: * **Empty slots** — Click to filter the search column to that card type. Click "Select Leader" or "Select Base" to start browsing leaders or bases in the search panel. As soon as both slots are filled, the search column drops that listing on its own and goes back to the cards your deck can play — you don't have to clear it first. * **Filled slots** — Show the card image in landscape format. Click to **remove** the card from your deck. Removing your Leader or Base clears your current search and lists every leader (or every base) so you can pick a replacement straight away. * **Flip a leader** — Hover a leader and click the **↻** button in its corner to see the other side: its unit side, or the second leader side of a double-sided leader. Click it again to flip back. On a touch screen the button is always shown. ![Screenshot: Leader and base slots](https://cdn.swuforge.com/how-tos/empty-workshop.png) ### Main Deck Grid Below the leader/base row, your main deck cards display as a **visual card grid**, sorted by cost then type. A stats bar above the grid shows your **Unit / Event / Upgrade** counts. The stats bar also has a **Group** dropdown with the same choices you get on the [deck page](/docs/decks/managing-decks.md) and the Browse deck panel: * **Cost** — one grid, cheapest cards first * **Card Type** — labeled sections for **Ground Units**, **Space Units**, **Events**, and **Upgrades**, easier to scan on a large deck * **Aspect** — a section per aspect combination: every card printing exactly the same icons together, so **Vigilance**, **Vigilance + Villainy** and **Villainy** are three separate sections. Sections follow the order aspects appear on the cards, an aspect printed twice reads **×2**, and cards with no aspect at all come last under **Neutral** * **Set Order** — a section per set (ASH, SEC, …), newest first Your pick follows you to those other views and to your next visit, and you can set the one you want to start with under [Settings → Deck Grouping](/docs/account/settings.md). The **maybe board** is arranged the same way. The sideboard is never split up — it stays a single list below the main deck. Next to it, the **image/list toggle** switches the deck area between full card images and a compact list of title/cost/stat rows. Your choice is remembered in your browser and carries across to the [deck view page](/docs/decks/managing-decks.md). Each card tile shows: * Card image * **Count badge** (diamond shape at the bottom) * On hover: **SB** button (move to sideboard), **−** button (remove copy), **+** button (add copy) * Hover popover with a larger card preview ![Screenshot: Main deck grid with card tiles](https://cdn.swuforge.com/how-tos/deck-grid.png) ### Sideboard If you have sideboard cards, they appear below the main deck in a compact 6-column grid. Each tile has: * Count badge * **MD** button — move back to main deck * **−/+** buttons — adjust quantity ### Maybe Board Below the sideboard sits the **Maybe Board** — a shortlist of cards you're considering for the deck. It is *not part of the deck*: it never counts toward your deck size, it's never checked for legality, and it is left out of every export, proxy sheet, and hand-off to Karabast. Think of it as a sticky note attached to the deck, one only you (and anyone who can edit the deck) can see. Add a card with the **MB** button — it's next to **SB** on every search result and on your deck rows. Adding to the maybe board changes nothing else: your main deck and sideboard stay exactly as they were. The maybe board holds cards that could go in your 50, so **MB** doesn't appear on tokens, leaders, or bases — you pick one leader and one base in their own slots at the top of the deck. Each maybe-board tile has: * Count badge * **MD** button — *copy* the card into the main deck * **SB** button — *copy* the card into the sideboard * **−/+** buttons — adjust how many copies you're considering The copy buttons are the important difference from the sideboard's. Sending a card to the main deck or sideboard leaves it on the maybe board, so a card can sit in both places at once; the only things that change the maybe board are its own **+**, **−**, and **MB**. Copy limits work the same way — three copies on the maybe board don't use up any of the three you're allowed to play. Importing a deck from **swubase** brings its maybe board along — the cards it had under consideration land on yours rather than being dropped, apart from any leader or base, which the maybe board doesn't take. Other import formats don't carry one, so those decks start with an empty maybe board. The maybe board is saved with the deck, so it's waiting for you next time. It travels with you between the Workshop, Browse, and the deck page, but it does **not** come along when someone copies your deck — a copy starts with an empty maybe board. ## Search & Filters (Right Column) The search column works similarly to the browse page (see [Browsing & Searching Cards](/docs/cards-and-search/searching-cards.md)) with a few workshop-specific behaviors: ### Format Toggle & Search Same Premier/Eternal toggle and Plain Language Search. The search pipeline is identical — single-word matching, title search, then Plain Language Search fallback. > The search input in the Workshop requires a **Foundry Apprentice** subscription or above. Without it, the input is disabled. You can still browse cards using the manual filters below. See [Getting Started](/docs/getting-started.md) for tier details. ![Screenshot: Workshop search input disabled for free users](https://cdn.swuforge.com/how-tos/workshop-search-disabled.png) ### Previous Searches The search input shows a **previous searches** dropdown on focus, just like the browse page. In the workshop, previous searches are **scoped to the current deck** — you only see queries you previously made while editing this specific deck. See [Browsing & Searching Cards → Previous Searches](/docs/cards-and-search/searching-cards.md) for full details. ### Filter Dropdowns **Sets** appears in both layouts: * **Sets** — Premier/Eternal quick-select or individual set checkboxes. Active sets display a **checkmark** next to their name so you can see at a glance which sets are included. Selecting the **Eternal** or **Premier** quick-select button also updates the format toggle in the search input above, keeping both controls in sync. Both controls only change which cards your search returns — your deck's own format is never changed by them. Clearing filters returns the set list to your deck's format, so an Eternal deck won't drop back to the Premier sets. Two dropdowns appear only in standard mode, because the quick-filter buttons stand in for them: * **Types** — Unit, Event, Upgrade * **Arenas** — Ground, Space The rest appear in **both** layouts, to the right of those: * **Aspects** — **Deck**, **Any**, and **All** modes. **Deck mode** auto-activates when both Leader and Base are selected, and the trigger shows a dot per active aspect. If a search has matches but **none** of them fit your deck's colors, Deck mode automatically turns off for that search so you still see the off-color results instead of an empty list. * **Power**, **HP**, **Cost** — click the number chips, or type an expression like `>= 5` or `<= 6, > 3`. You can compare against another stat too, with simple math: `>= cost + 2` in the Power box finds cards with at least 2 more power than cost * **Keyword** — Sentinel, Raid, Ambush, and the rest; picking more than one matches cards with any of them * **Ability** — When Played, On Attack, and the other ability types found in the card pool * **Trait** — searchable, since there are hundreds * **Rarity** — Common, Uncommon, Rare, Legendary, Special In the Power, HP, Cost, Keyword, Ability, Trait, and Rarity dropdowns, **Clear** sits at the top of the list and resets just that filter. It's greyed out until you've picked something. Whichever dropdown you use, the filter is written back into the search bar as the query it stands for — pick **Arena: Ground** while searching `snowtrooper` and the bar reads `arena(Ground) snowtrooper`. That way a new search visibly replaces what you had rather than silently clearing it, and you can adjust the query by hand or by dropdown. See [The Filters Write Themselves Into the Search Bar](/docs/cards-and-search/searching-cards.md#the-filters-write-themselves-into-the-search-bar). ### Quick Filters (Card Type Macros) If you select the **Card Type Macros** filter layout in [Settings](/docs/account/settings.md), the workshop filter bar is simplified: * **Type** and **Arena** dropdowns are removed * **Quick filter buttons** — **Space**, **Ground**, **Events**, **Upgrades** — act as radio buttons to quickly filter card types and arenas * **Sets**, **Aspects**, **Power**, **HP**, **Cost**, **Keyword**, **Ability**, **Trait**, and **Rarity** stay exactly where they are — the buttons stand in for Type and Arena, so nothing else is taken away, and the Aspect dropdown is the same one standard mode uses ### Search Results Results appear as a **scrollable list** below the filters. Each row starts with a **copies picker** — **0 1 2 3**, with the number you currently have highlighted. Click a number to set the card's count in one go, or **0** to take it back out. Numbers beyond what the card allows are greyed out, and the rare card that allows more than three copies gets a typeable box with **−** and **+** instead. The card's cost sits on the right of the row with its power and HP. #### Aspect Penalty Once your deck has a Leader and a Base, each row also shows what the card's off-aspect icons would add to its cost — **+2** for every aspect icon your Leader and Base don't cover, in orange just before the cost. With a red Base and a green-and-white Leader, a blue-and-white card reads **+2** (the white is covered, the blue isn't) and a blue-and-black card reads **+4**. An aspect printed twice needs your deck to bring it twice: a double-blue card with only one blue between Leader and Base still pays **+2**. Cards your deck covers in full show nothing. It's a reading aid and nothing more — it never changes your search, your filters, or the deck itself. Hover the number to see which aspects you're paying for. Turn off **Deck** mode in the Aspects filter to see off-aspect cards in the first place; the same numbers appear on your deck, sideboard and maybe-board rows. On a phone the row keeps the name readable instead: the picker becomes a compact **− 1 +** counter, and **SB**/**MB** fold behind a **…** button that opens them in place. Tap anywhere on the row to put them away again. ### Default Card Pool When you have both a Leader and Base selected but haven't searched, the search column shows **all playable cards** for your deck's aspects, sorted by cost. This lets you browse and build without needing to search. Once your deck has a Leader, search results stop showing Leaders, and once it has a Base they stop showing Bases — each independently — so the list stays focused on cards you can still add. Filling the last empty slot from the slot picker hands the column straight back to this pool. To swap a Leader or Base out later, filter by **Leader** or **Base** in the Type filter to bring them back; that choice is yours and stays until you change it. ![Screenshot: Search column with results](https://cdn.swuforge.com/how-tos/workshop-search.png) ## Deck Building Flow A typical workflow in the workshop: 1. **Select a Leader** — Click the empty Leader slot, browse leaders in the search panel, click one to add 2. **Select a Base** — Click the empty Base slot, browse bases, click one to add 3. **Browse the card pool** — With both selected, the search panel shows all playable cards filtered by your deck's aspects 4. **Add cards** — Click cards in the search results to add them to your deck grid 5. **Fine-tune** — Use search to find specific cards, set counts with the row's 0/1/2/3 picker, move cards to sideboard 6. **Save** — Click Save in the header bar Alternatively, you can **import a deck** directly in the workshop. When the deck area is empty, an **"Import from file or URL"** button appears below the leader/base slots. Click it to open the import dialog where you can drag & drop a deck file, paste deck content directly, or paste a URL from SWUDB, SWUBase, or Melee. The imported deck populates inline — no navigation required. The deck format is **auto-detected** from the card pool, and the search format toggle switches to match. After importing, the **Save button pulses** with a tooltip ("Deck imported — save to keep it") to remind you to save. ## Header Actions The workshop header includes: * **Deck name** (or "New Deck") with a **format badge** — a small colored pill showing **Premier** (blue) or **Eternal** (purple). This badge is read-only in the workshop; to change the deck's format, use the [deck detail page](/docs/decks/managing-decks.md). * **Inline rename** — On a saved deck of your own, click the deck name to edit it in place. A subtle underline appears on hover to show it's editable. Press **Enter** or click away to keep the new name, **Escape** to cancel. The new name takes effect straight away — there's no need to press Save, and cards you've added but not yet saved stay exactly as they are. * **Unsaved indicator** — Shows when you have unsaved changes * **View** button — Go to your deck's public view page (only for saved decks) * **Browse** button — Switch to the browse page with your deck loaded in the side panel * **Save** button — Save your deck. New decks open a dialog for name and folder; existing decks save instantly. The folder picker groups choices under **Personal** and each **team** (team folders show the team's icon), lists folders in your custom order, and indents subfolders to show nesting. Only folders you can write to are offered — team folders where you're a VIEWER are hidden. * **Versioning** button — Open the version tree panel (available to all logged-in users). See [Deck Versioning](/docs/decks/managing-decks/deck-versioning.md) for details. ![Screenshot: Workshop header with action buttons](https://cdn.swuforge.com/how-tos/workshop-header.png) ## Autosave & Recovery The workshop autosaves your work to the browser every 500ms. If you accidentally close the tab and come back, a banner appears offering to **Restore** or **Discard** your unsaved changes. ## Mobile Experience On mobile devices (under 768px): * The deck grid fills the screen * A **search tab button** (bottom-right) opens the search drawer * The search drawer slides in from the right as an overlay * Tap the backdrop to close it ![Screenshot: Mobile workshop with search drawer](https://cdn.swuforge.com/how-tos/workshop-mobile.gif) ## Workshop vs. Browse Page | | Browse Page (`/search`) | Workshop (`/workshop`) | | ------------------ | ------------------------------------ | ----------------------------------- | | **Primary focus** | Card search & discovery | Visual deck layout | | **Deck display** | Side panel (collapsible) | Main content area (always visible) | | **Search display** | Main content area | Side column / drawer | | **Best for** | Starting a new deck, exploring cards | Fine-tuning a deck, visual overview | | **Filters** | The full manual set | The same, minus set-level filtering | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://swu-forge.gitbook.io/docs/decks/workshop.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.