# Manual

> The Showcaser manual: every section of the guide that ships inside the app, readable here as HTML or raw Markdown.

Everything Showcaser does, one short section at a time. The same manual ships inside the app, under About.

## Getting started

- [What Showcaser is](/docs/what-showcaser-is.md) (GS-1): The one-page orientation: a calm website for things you sell in person, run from your own iPhone, iPad or Mac
- [Your first showcase](/docs/your-first-showcase.md) (GS-2): Putting a showcase on a new device with its recovery key, or creating a new one, and what it starts with
- [Your key and iCloud Keychain](/docs/the-key.md) (GS-3): How a showcase is owned with no account, where its key lives, and how to back it up and restore it
- [Several showcases](/docs/several-showcases.md) (GS-4): Switching between showcases, managing the list on a device, and taking one off a device
- [Finding your way on iPhone and iPad](/docs/the-home-screen.md) (GS-5): The list of places on the iPhone, the sidebar and cards on the iPad, going back, Side by Side, and where Settings is
- [Searching the app](/docs/searching.md) (GS-6): The magnifying glass beside the showcase's name (⌘F) finds listings, pages, settings and this manual

## Listings

- [Adding a listing](/docs/adding-a-listing.md) (LS-1): Starting a new listing, what its form holds from top to bottom, and how its name and web address are made
- [Photos and video](/docs/photos-and-video.md) (LS-2): Adding, ordering and removing a listing's photos and video, and what the app does to them before they go up
- [Statuses and the status note](/docs/statuses.md) (LS-3): What a listing's status does on the site and in the app, the quick ways to change it, and the private note beside it
- [Details, summary and description](/docs/details-summary-description.md) (LS-4): Filling in a listing's fields by type, adding a new choice from a listing's form, and formatting the description
- [Only in this app](/docs/only-in-this-app.md) (LS-5): Private fields and the status note, sealed with your showcase's key so the site never shows them and the host can't read them
- [Publishing, hiding and deleting](/docs/publishing-hiding-deleting.md) (LS-6): What Publish sends, seeing a listing on the web, taking one off the site for now, and deleting it for good
- [When two devices edit at once](/docs/two-devices.md) (LS-7): How the app keeps your iPhone, iPad and Mac from saving over each other, and what each question means
- [Dimensions and View on your wall](/docs/dimensions.md) (LS-8): Giving a piece a real width and height, how the site uses it, and how visitors see it at its real size in their own room

## Your site

- [Site details and contact](/docs/site-details.md) (ST-1): Your site's name and subtitle, the phone at the top, the contact details visitors use, the About text and the footer
- [Pages and tabs](/docs/pages.md) (ST-2): Adding the pages that become your site's tabs, writing them, putting photos on them, and ordering or deleting them
- [Header photo](/docs/header-photo.md) (ST-3): A photo across the top of your site's pages, under your name and tabs, and when a page shows a different one
- [Cards and Gallery layouts](/docs/layouts.md) (ST-4): Choosing how your site arranges its listings, each layout's options, and the name of the first tab
- [The Gallery's wall](/docs/the-gallery-wall.md) (ST-5): How the Gallery layout hangs every piece at its real size on a gallery wall, and what visitors can do there
- [Fonts](/docs/fonts.md) (ST-6): Choosing a face for your site's name and tabs and another for its text, from a short list served by your own site
- [Themes](/docs/themes.md) (ST-7): Choosing your site's colors from the ready-made themes in Site, Layout, and how the app wears them too
- [Making your own theme](/docs/making-a-theme.md) (ST-8): Making a theme from a few colors in Settings, Themes, importing one as JSON, and putting it on your site
- [Your address](/docs/your-address.md) (ST-9): Where your site lives on showcaser.app, how a new showcase gets its address, and changing it
- [Your own domain](/docs/own-domain.md) (ST-10): Putting your site at a domain you already own, the one or two records to change where your domain is managed, and disconnecting
- [What visitors see](/docs/what-visitors-see.md) (ST-11): Your site's home page, a listing's page, the Contact page and the light and dark switch, as a visitor meets them
- [Search, sorting and categories on the site](/docs/search-on-the-site.md) (ST-12): How visitors search your listings, the sorts they can use, and the category buttons above the list

## Listing schema

- [The listing schema](/docs/listing-schema.md) (SC-1): What a listing schema is, the four built-in ones, how the first change makes one your own, and switching between them
- [Fields and their types](/docs/fields-and-types.md) (SC-2): Adding, renaming, reordering and retyping your schema's fields, and which types a field can be
- [Headline, search and When empty](/docs/headline-search-empty.md) (SC-3): Choosing which fields make a listing's name, which ones the site searches and sorts by, and what an empty field says
- [Statuses in the schema](/docs/schema-statuses.md) (SC-4): Adding and editing statuses, the home tab each falls under, and whether the site shows and marks it
- [Removing fields and statuses](/docs/removing-fields-and-statuses.md) (SC-5): Taking a field out of your schema with or without its values, hiding one, and removing a status by moving its listings first

## On the Mac

- [The Mac window](/docs/mac-window.md) (MAC-1): The sidebar and the cards: your site's pages (the listings among them), the Site card and the foot, each a card
- [Cards side by side and in windows](/docs/cards-and-windows.md) (MAC-2): Putting two cards next to each other, closing a card, moving one to a window of its own, and keeping an arrangement
- [Drag and drop](/docs/drag-and-drop.md) (MAC-3): Bringing photos and video in from the Finder or Photos, starting a listing by dropping photos, and reordering by dragging
- [Keyboard shortcuts](/docs/keyboard-shortcuts.md) (KB-4): The keys the Mac app answers to, and where to find them in the menus

## Privacy and safety

- [What is stored, and what never is](/docs/what-is-stored.md) (PR-1): What your showcase's host keeps, what it can't read, what it never learns about you or your visitors, and who can change your site
- [Photos and honest pictures](/docs/honest-pictures.md) (PR-2): What happens to every photo and video before it leaves your device, and what Showcaser will never do to a picture

## Help

- [Troubleshooting](/docs/troubleshooting.md) (TS-1): What the app's messages mean and what to do, from a missing showcase to a video that's too long
- [Release notes and What's new](/docs/release-notes.md) (TS-2): Where to read what changed in each update, and the build you are on
- [Report an Issue](/docs/report-an-issue.md) (TS-3): Tell the people who make Showcaser about a problem or an idea, from the app or the website