> 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 home page features a search bar available to **everyone** — even without signing in. Type a query and hit Enter to search using Plain Language Search. Animated prompt suggestions cycle through the input to inspire your queries.

Below the search bar you'll find a **"browse all cards"** link to jump straight into the full card browser.

![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 + 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](/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** — Plain Language Search from the home page works for everyone
* **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

![Screenshot: Disabled search input with subscribe banner on browse page](https://cdn.swuforge.com/how-tos/search-disabled-banner.png)

## Where to Go Next

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


---

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