Skip to content
StackyardStackyard

Customization

In the admin: Appearance. See the Settings reference.

Set in the admin UI under Appearance. Everything applies immediately.

Turning titles off gives a denser grid of icons alone.

Settings Display Mode affects the Settings pages only. The dashboard stays dark: no stylesheet declares a prefers-color-scheme rule, so it does not follow the operating system.

Increased contrast and reduced motion are honoured. Reduced transparency drops the blur behind cards and keeps the motion.

The Appearance section of the admin UIThe Appearance section of the admin UI
Appearance, in the admin UI.

Wallpaper

Section titled “Wallpaper”
SourceWhat it does
ImageUpload a file, or paste a link that is downloaded once.
Solid colorA single colour behind the grid.
UnsplashA random image, or one from a collection. Needs an Unsplash API key.

Brightness dims the wallpaper so tiles and labels stay readable. Fit chooses Fill or Fit.

Uploaded and linked images are stored on your own server and served from it. Choosing Image or Solid color means Unsplash is never contacted. See Security.

Getting an Unsplash key

Section titled “Getting an Unsplash key”

Unsplash needs a free developer account. The key is a plain string you paste into Appearance, Wallpaper, API Key.

  1. Sign in at unsplash.com/developers.
  2. Choose Your apps, then New Application. Accept the API terms.
  3. Give it any name and description. A demo application is enough for personal use.
  4. Open the application and copy the Access Key.

Paste the Access Key, not the Secret Key. Stackyard only reads public photos and never needs the secret.

A demo application is rate limited to 50 requests per hour. Stackyard asks for one image at a time, so that is ample.

Finding a Collection ID

Section titled “Finding a Collection ID”

Leave Collection ID blank for a random photo from all of Unsplash. Set it to pull only from one collection.

The ID is the number in the collection’s own URL:

https://unsplash.com/collections/1234567/collection-name

Paste only the highlighted number, not the whole URL.

Language

Section titled “Language”

Six languages ship: English, Persian, Simplified Chinese, Spanish, German, and French. Change it in General.

Persian is right to left. The whole layout flips, not only the text.

On a phone

Section titled “On a phone”

Stackyard has a real mobile layout, not a shrunken desktop one. The grid re-flows, the search bar moves within thumb reach, and the settings sidebar becomes a tab bar.

Add it to your home screen and it opens in its own window, without browser chrome.