> 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/getting-started.md).

# Getting Started

Welcome to **SWU Forge** — a deckbuilder and card browser for Star Wars Unlimited.

## Home Page

The search bar at the top of the home page works for **everyone**, signed in or not. You can type:

* **A card name** — `luke skywalker`
* **A set and card number** — `SOR 33` opens that card's page. A hyperspace, showcase or prestige number works too: `SOR 299` opens Death Trooper on its Hyperspace art.
* **A collector number on its own** — `196` lists the card at that number in every set.
* **Filters** — `aspect(red) cost(>4)` in Forge Syntax or `c:r cost>4` in Scryfall Syntax. The **Forge** and **Scryfall** links under the search bar open the full guides.

Press Enter to see the results on the Browse page. **Browse all cards** jumps straight into the full card browser.

**Start from a popular deck** offers templates for popular Premier decks. Each one gives you a leader, a base and a starting set of cards. Click a template to open it in the Workshop as a new deck, then add your own cards and save it. You'll be asked to sign in first if you aren't already.

If you aren't signed in, the rest of the page gives a quick tour of what SWU Forge does — searching, the Workshop, the Battle Log, replays, teams and public decks — with a link to each.

Once you're signed in, the home page shows your **recent decks** (the five you've changed most recently, with a **New deck** button) and your **recent replays** (your five latest recorded games, each with your leader, your opponent's leader and the result). Click any of them to jump straight back in. If you haven't recorded a game yet, that panel links to the guide for setting up recording and, on a computer, to the Kara Tracker browser extension. Everything else is in the menu at the top of the page.

![Screenshot: Home page with search bar](https://cdn.swuforge.com/how-tos/homepage.png)

## Signing In

Click **Sign in** in the top-right corner. You can sign in with either:

* **Google** — use your Google account
* **Discord** — use your Discord account

![Screenshot: Sign-in buttons on the home page](https://cdn.swuforge.com/how-tos/sign-in-buttons.png)

Once signed in, your avatar appears in the top-right. Click it to access **Settings** or **Sign out**.

![Screenshot: User menu showing avatar and dropdown](https://cdn.swuforge.com/how-tos/user-menu-signed-in.png)

Signing in unlocks **deck building and saving** — you need an account to create, save, and manage decks.

## Subscription Tiers

SWU Forge offers additional features through a paid [subscription](https://swuforge.com/subscribe):

| Tier                   | Price                | Perks                                                                                                                                       |
| ---------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Foundry Apprentice** | $20/yr (annual only) | Plain Language Search on the Browse and Workshop pages                                                                                      |
| **Foundry Smith**      | $5/mo ($50/yr)       | Everything above + scanning cards into your collection from a photo, early access to feature previews, beta testing, supporter Discord role |
| **Forge Master**       | $10/mo ($100/yr)     | Everything above + high-priority feature requests, supporter recognition                                                                    |

Your current tier is displayed in the user menu. Non-subscribers see **"Free Plan"** with a link to subscribe. See the [Membership & Subscriptions](https://swu-forge.gitbook.io/docs/account/membership.md) guide for full details on tiers and billing.

![Screenshot: User menu showing subscription tier badge](https://cdn.swuforge.com/how-tos/user-menu-tier.png)

![Screenshot: User menu showing Free Plan with subscribe link](https://cdn.swuforge.com/how-tos/user-menu-free-plan.png)

### What's available without a subscription

* **Homepage search** — card names, set and card numbers, and filter syntax
* **Card browsing** — Browse all cards with manual filters on the `/search` page
* **Deck building** — Build and save decks (requires sign-in but no subscription)
* **Prompt Suggestions** — Submitting search improvement suggestions (requires sign-in but no subscription)

### What requires a subscription

* **Plain Language Search on Browse/Workshop** — The search input on `/search` and `/workshop` requires a **Foundry Apprentice** subscription or above

## Where to Go Next

* [**Browsing & Searching Cards**](https://swu-forge.gitbook.io/docs/cards-and-search/searching-cards.md) — Learn how to find cards using search and filters
* [**Building a Deck (Browse Page)**](https://swu-forge.gitbook.io/docs/decks/building-deck-browse.md) — Start building a deck from the browse page
* [**The Workshop**](https://swu-forge.gitbook.io/docs/decks/workshop.md) — Use the full visual deck editor
* [**Managing Your Decks**](https://swu-forge.gitbook.io/docs/decks/managing-decks.md) — Save, organize, share, and export decks
* [**Settings**](https://swu-forge.gitbook.io/docs/account/settings.md) — Customize your card art preferences
