Skip to content

Paper, frames and covers ​

Photos aren't pasted on top of the page. They take on the paper's ink, sit under its grain, and curve with it into the spine, so a page looks printed.

Paper ​

paper
ivoryWarm, lightly textured. The default.
whiteBright and clean.
kraftBrown, fibrous, photos warmed toward sepia.
charcoalDark board with pale ink, photos slightly dimmed.

PAPER_COLORS lists them with a swatch colour for pickers.

Frames ​

Every frame is printed into the paper: rules, tints, a pressed plate, never a raised border. A photo's frame wins over its page's, a page's wins over the book's, and full-bleed pages are never framed. photoFrame(page, photo, book.frame) gives the frame a photo ends up with.

frame
noneThe photo printed straight onto the page.
hairlineA fine printed rule.
doubleTwo rules, like a classic album keyline.
matA wide printed mat with a thin frame line.
cornersPrinted album corners.
deckleA vintage print with a scalloped border.
plateA plate pressed into the paper.
featherThe photo fades into the paper.
ovalAn oval cameo inside a fine ring.
botanicalLine-drawn sprigs of leaves around a fine rule.
watercolorA wash of soft colour around a mat.
arcsA border of little rainbow arcs.
giltAn engraved border in gold ink.
woodgrainA printed woodgrain border.

FRAME_STYLES has a label and a one-line description for each.

Covers ​

coverDesign sets how the front board is made. Every design is printed into the cloth you pick, with the same grain, sheen and hinge, so any design suits any book.

Design
classicA ruled panel with the title over an inset photo. The default.
giltGold rules and corner flourishes around an oval portrait.
windowThe photo set into a window pressed into the board, the title stamped below.
labelA print held by photo corners over a paper title label.
decoGold rays rising to an arched photo.
imageYour cover photo across the whole board, finished and tinted like the cloth.

The image design is for a cover that is all picture. It carries no text unless you ask for it with coverText: true, which lays the title over the foot of the image. Any other design prints its title by default, and coverText: false leaves it off.

ts
const book = {
  title: 'Amaka & Tobi',
  cover: { src: '/wedding/portrait.jpg' },
  coverDesign: 'image',
  theme: 'midnight',
  // ...
}

theme picks the cloth: classic (oxblood with gold ink), linen (natural with brown ink), midnight (navy with silver ink), leather (tan with gold ink), sage (green with cream ink) or blush (rose with plum ink). The stage behind the book is tinted to match unless you pass background.

COVER_DESIGNS and COVER_THEMES have a label for each, for building a picker. coverHasText(book) tells you whether a book's cover will carry its title.

Restyling on the web ​

All classes start with fb-. These custom properties can be set on .fb-root or any parent:

Property
--fb-serifThe book face, Fraunces by default.
--fb-sansThe viewer's controls.
--fb-accentThe highlighted slot in an editor.
--fb-highlightThe current thumbnail and drop targets.

The paper textures ship next to the stylesheet. Bundlers like Vite and webpack pick them up from the CSS on their own.