> 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/building-deck-browse.md).

# Building a Deck (Browse Page)

The **Browse** page (`/search`) is designed as the starting point for building a new deck. You search and browse cards in the main area while your deck grows in a side panel. Think of it as *search-first* deck building — the card pool is front and center.

## Starting a New Deck

There are a few ways to start:

* Click **New Deck** in the toolbar (on mobile, this is a half-width button next to the **Filters** button). A dialog opens where you can choose a format (**Premier** or **Eternal**), import a deck, or build from scratch.
* Navigate to `/search?new=1`
* Start adding cards directly — a deck is created automatically

## The Deck Side Panel

Once you start building, a **deck tab** appears on the right edge of the screen. Click it to expand the side panel showing your deck in progress.

![Screenshot: Deck side panel tab](https://cdn.swuforge.com/how-tos/new-deck-browse.png)

### Tab Indicators

The tab shows at a glance:

* **Card count** — Total cards in your main deck
* **L / B boxes** — Green when Leader and Base are selected
* **Orange dot** — Appears when you have unsaved changes

You can **drag the tab** up or down to reposition it on screen.

### Panel Header

The panel header shows the deck name with a **format badge** — a small colored pill indicating **Premier** (blue) or **Eternal** (purple). This badge is read-only on the browse page; to change the deck's format, use the [deck detail page](/docs/decks/managing-decks.md). A **close button** (X) in the header lets you clear the deck and dismiss the side panel.

### Panel Contents

The side panel shows your full deck list:

**Leader & Base** — At the top. If empty, click **"Select Leader"** or **"Select Base"** to filter the main card grid to that type. Once selected, they appear as rows with aspect icons and stats. Hover for a card image preview. Click the **X** to remove.

**Main Deck** — Shows `"Main Deck (X/Y)"` where Y is your target deck size (usually 50, varies by base). Cards are listed with:

* Card name and stats
* Count badge (e.g., 3x)
* **+/−** buttons to adjust quantity
* **SB** button to move to sideboard

**Sideboard** — Appears below the main deck if you have sideboard cards.

![Screenshot: Deck side panel expanded with cards](https://cdn.swuforge.com/how-tos/side-panel.png)

## Adding Cards to Your Deck

As you browse or search, each card tile shows deck-building controls on hover:

* **+ button** — Add a copy to your deck
* **− button** — Remove a copy
* **SB button** (lower-left) — Add the card directly to your sideboard without first putting it in the main deck. Only appears once a deck is active and does not show on Leaders, Bases, or tokens.
* **Count badge** — Shows how many copies are in your deck

Cards are limited to their maximum copies (typically 3, or 1 for unique cards). The + button disables when you've hit the limit.

![Screenshot: Card tile with add/remove buttons](https://cdn.swuforge.com/how-tos/add-remove-browse.png)

## Smart Filtering

Once you've selected both a **Leader** and a **Base**, the browse page helps you focus:

* **Leader and Base cards** drop out of results once your deck holds that slot — pick a Leader and Leaders disappear, pick a Base and Bases disappear (each independently; unless you explicitly filter by those types — see [Browsing & Searching Cards](/docs/cards-and-search/searching-cards.md))
* **Aspect mode** switches to **Deck** — showing only cards playable without an aspect penalty
* **Sort** switches to Cost: Low to High
* Cards are ready to browse immediately

You can always override these by changing filters manually.

## Saving Your Deck

Click **Save** in the side panel header. If it's a new deck, a dialog appears where you can:

* Enter a **deck name**
* Choose a **folder** to organize it in

Your deck also **autosaves** to your browser in the background. If you accidentally close the page and come back, you'll see a banner offering to **Restore** or **Discard** your unsaved changes.

![Screenshot: Save deck dialog](https://cdn.swuforge.com/how-tos/save-deck.png)

## Moving to the Workshop

When you're ready for a more visual editing experience, click the **Workshop** button (compass icon) in the side panel header. Your deck transfers over to the full multi-column workshop layout.

See [**The Workshop**](/docs/decks/workshop.md) for details on the workshop experience.

## Importing a Deck

You can import a deck from multiple places:

* **From the browse page** — When the deck side panel is empty, an **"Import from file or URL"** button appears. Click it to open the import dialog and load a deck inline without leaving the page.
* **From the workshop** — Same import button appears in the empty deck area.
* **From My Decks** — Click **New Deck** on the `/decks` page to open the import dialog.

The import dialog supports:

* **Drag & drop** a `.json` (SWUDB or SWU Forge export) or `.txt` (Melee export) file
* **Paste deck list** — copy and paste deck content directly (JSON or Melee text format)
* **Paste a URL** from SWU Forge, SWUDB, or Melee to import a decklist
* **Build from scratch** — choose a format (Premier or Eternal) and start with an empty deck

When importing, the deck format is **auto-detected** based on the card pool — if any card in the imported list belongs to a non-rotation set, the deck is marked as Eternal. The search format toggle also switches to match the imported deck's format.

After importing, the **Save button pulses** with a tooltip ("Deck imported — save to keep it") to remind you to save the imported deck.

![Screenshot: Import deck dialog](https://cdn.swuforge.com/how-tos/import-decks.png)


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://swu-forge.gitbook.io/docs/decks/building-deck-browse.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
