Kirby 5 Templates · Yirang Ok

Books — setup guide

Every publication becomes a real 3D object, built from three images and three numbers. This walks through installing the template and adding your first book. Nothing here needs the command line beyond one copy-paste.

Live demo Buy — €49

01 Put the files on a server

You need PHP 8.2 or newer. Any shared host will do — no database, no build step, nothing to compile.

Unzip the download and upload the whole folder to your web root. If your download already contains a kirby/ folder you are ready. If it does not, install Kirby alongside it:

composer require getkirby/cms

To look at it on your own machine first, run this inside the folder and open localhost:8000:

php -S localhost:8000 router.php

02 Make your Panel account

Open /panel on your site. The first time, Kirby asks for an email and a password and makes you the administrator. That account is stored in your own files — there is no service to sign up for.

The Kirby Panel login screen — After the first setup this is the screen you come back to.

On a live domain, Kirby requires HTTPS before it will let you install. If your host has not issued a certificate yet, do the setup locally first and upload site/accounts/ with the rest.

03 Find where the books live

Books live on the Site screen — the section labelled “Books”. Everything else on your site stays out of the way.

The Panel screen listing every book — The Site screen. Each card is one book; “Add” makes another. Five show at a time — page through with the arrows.

04 Add a book

Press Add, give it a title, and open it. These are the fields:

One book open in the Panel, showing its fields — One book. The three images on the right, the real millimetres on the left.

Title: The book’s name. Shown in the list view.
Cover: Front cover image. One file.
Back: Back cover image. One file.
Spine: Spine image. One file.
Dimensions: Width, Height and Spine in millimetres — the real ones. A 15 mm novel will look thin next to a 75 mm monograph, because the template builds the geometry from these numbers.

Worth knowing. Use the actual print dimensions. The whole point of the template is that the shelf is to scale — guessing round numbers flattens the effect you paid for.

05 Look at the site

Nothing to publish or rebuild — the front end reads the same files the Panel just wrote. Reload and it is there.

Books running with its demo content — The result. Books orbit until someone clicks one.

Colour. The page colour is one field on the Site screen — Background colour. Pick anything; the List button, the index and the loading bar switch between a light and a dark look on their own so they stay readable.

06 Replace the demo content

The books that came with the template are original work and yours to keep, reuse or delete. Delete them from the Panel like any other page once your own are in.

Kirby is a paid CMS: a production licence is about €99 from getkirby.com and is not included with this template. You can develop and preview locally for free for as long as you like — the licence is for the live site.