Getting started

Before you begin

You need a Zukan server address and an account accepted by that server. A server administrator creates local accounts; SSO accounts may be provisioned at first login by the configured identity provider. There is no general public self-registration workflow in Zukan itself.

Sign in

1. Open the server address in a current browser.
2. If a local login form is available, enter the username and password supplied by the administrator.
3. If the server offers SSO, select the provider and finish its sign-in flow. With local login disabled and exactly one provider, redirection may happen automatically.
4. Confirm that the Dashboard appears.

The provider's pages can use a different language and visual style. Your identity provider credentials are entered on its own sign-in page.

Set your preferences

Open Settings. Select the interface language, games visible in the catalog and price sources. At least one price source must remain selected. If you enable several, select the main source used for valuation and sorting. The light/dark control is in the page header.

Hiding a catalog does not remove its cards or delete any collection items. See Account and preferences.

Add your first card

1. Open Catalog and select a game, or search all visible games.
2. Search by a printed name. Names in other catalog languages are searchable too.
3. Open the card page and identify the correct set, collector number and printing.
4. Open its stock controls. Choose finish, condition, language and quantity.
5. Choose Add and check the result in Collection.

A card name alone is insufficient to identify what you own. Reprints, different rarities and regional editions may have different prices and images.

Read the Dashboard

The Dashboard shows collection value, valuable cards, price movers, a value chart and recent stock changes. A new account starts empty. Missing prices or short price history can leave widgets empty even after cards have been added.

The value chart uses today's holdings priced with historical market snapshots. It is not a record of purchases or cash invested. See Prices and valuation.

Use Android with the same collection

Install the APK linked by the web interface or the project's releases. Enter the same server address and sign in to the same account. A phone needs a reachable domain or LAN address; localhost points to the phone.

See Android guide for scanning and troubleshooting.

Implementation references

• web/src/pages/Dashboard.tsx
• web/src/pages/Login.tsx
• web/src/pages/Settings.tsx