Tutorial 1 of 205 min read

Cards Page Overview

A guided tour of the ShuffleKit Cards page: the spreadsheet grid, action bar, live card preview, side panel, and deck tabs, and how they fit together.

The Cards page is where your whole game lives. Every card is a row, every piece of card data is a column, and the artwork you see on the right is rendered live from those two things plus a layout.

The ShuffleKit Cards page

Before you start

The Cards page belongs to a project. If you are coming from onboarding, you can arrive here in one of three ways:

  • Import from CSV: your columns become properties and your rows become cards.
  • Create with AI: choose a layout first, then ShuffleKit drafts starter cards to fit it.
  • Start empty: choose a template or begin with a blank layout and add everything yourself.

The first two paths create the project structure before you reach the grid. AI card writing and artwork may continue after the Cards page opens, so a project can be usable before every starter card has finished. If a generation status strip appears, keep working; unfinished artwork can be retried from its image cell.

On smaller screens the spreadsheet switches to a compact layout and deck selector. The full layout editor is intended for desktop; use the Cards page on mobile for checking data, cards and previews.

The quickest first pass

You do not need to learn every control before making something real. On a new project, this sequence gets you from an empty grid to a card you can proof:

  1. Add a Text property called title, an Image property called artwork, a Select property called Type, and a Text property called ability.
  2. Add two or three cards and fill in those values.
  3. Create a deck, add the cards to it, and set any card that needs multiple copies in the deck's QTY column.
  4. Open Cards Layout Template and choose a built-in template, or create a blank layout.
  5. Bind the title, artwork and ability elements to their properties, then turn on Preview mode.
  6. If different cards need different frames, add a second layout and give it a condition based on Type.

Parts 2 to 8 unpack each of those steps. This first pass is deliberately small: three cards are enough to expose a missing binding, a bad condition or text that does not fit.

The five regions

1. The mode switch (top-left)

Two tabs sit at the very top:

  • Cards Spreadsheet is the data view you see above.
  • Cards Layout Template is the visual designer where you build the card's look. See Layouts & the Template Editor.

They are two views of the same cards. Change a title in the spreadsheet, commit the edit, and the layout preview updates instantly.

2. The action bar

  • Add Card appends a new blank card.
  • Import / Export brings data in from CSV, Excel, JSON or Illustrator, and pushes cards out as images, PDFs or virtual tabletop packs. See Import & Export.

When rows are selected, this bar swaps to bulk actions. See Working With Cards.

3. The grid

Each row is one card. The columns are:

  • DECKS: which decks this card belongs to (system column).
  • Status: Draft, Active or Archived (system column).
  • Your properties: title, artwork, ability, powers, Type in the example above. These are yours to define.
  • The + at the far right of the header adds a new property.

Inside a deck tab, DECKS becomes the system QTY column. QTY is the number of copies that deck prints or plays; it is not a custom Number property. See Decks for the difference.

An asterisk (*) next to a column name means the property is required. The small chain icon means the property is connected to a layout element.

4. The side panel

Three tabs:

  • Card Details: a live render of the selected card, plus a filmstrip of your cards.
  • Shufflo AI: generate and balance cards with AI.
  • Notes: playtest feedback flagged against this card.

Icons at the panel's top-right open version history, and flip the preview to the card back when your project has back layouts.

5. Deck tabs (bottom)

All cards plus one tab per deck, and a + to create a new deck. See Decks.

Getting more room

Click Panel in the top-right to collapse the side panel. The grid expands to the full window width, which is useful when you're doing a bulk data pass rather than art direction.

The Cards page with the side panel hidden

Click Panel again to bring it back.

The mental model

It helps to hold these three ideas separately:

Concept Lives in Answers
Properties Spreadsheet columns What data does a card carry?
Layouts Layout Template tab What does a card look like?
Conditions Attached to layouts Which look does this particular card get?

A card is the intersection: its property values poured into whichever layout its conditions select. Once that clicks, the rest of the Cards page is straightforward.

Keyboard shortcut

⌘K (Ctrl+K on Windows) jumps straight to the card search box.

Ready to build your card game?