Administration
This page is for the person who runs a Bibliotome site. Admins get Admin in the account menu, which opens six tabs: Dashboard, Users, Genres, Themes, Settings and Audit.
Being an admin doesn’t let you see anybody’s library. The admin pages show how many tomes an account holds, never which ones, and an admin opening someone else’s Anthology link sees only what any visitor would. You never choose or see anyone’s password either.
Anything that can’t be undone asks first, on a page that says what will happen, with Cancel ready.
Setting up a new site
Section titled “Setting up a new site”A new Bibliotome has no accounts, and every page goes to Set up your site. Enter What this site is called (you can change it later), a username, email and password, and select Create account. That first account is the admin, and you’re logged in to your own Sanctum straight away. The address you opened the page on is recorded as the site’s Canonical URL. The setup page closes for good once it has run, even if every account is later deleted.
A new site starts with registration closed, email off and sharing on. Go through Settings before inviting anyone.
Dashboard
Section titled “Dashboard”The dashboard starts with anything that needs doing:
- accounts waiting for approval, with a link to review them,
- registration open while email is off, so nobody can confirm an address or reset a password, and every new account waits for you to approve it (even if registration is set to Open), or
- sharing switched off site-wide.
Then two cards show whether the site is working:
- Email: off, nothing sent yet, working or failing. It counts the last week’s mail by kind and whether each was sent, refused or failed, and names the last one that was refused or failed, with the reason.
- Scheduler: never run, working, late or failing. Bibliotome’s housekeeping runs every fifteen minutes, clearing expired sessions and links, old records and sign-ups nobody confirmed. The card says when it last ran and names any problems. Run housekeeping now runs it straight away.
Below those, the counts across the whole site: Accounts, Tomes, Reads, Authors, Series, Genres, Anthologies, how many of those are Shared, and how many sessions are Signed in. Who has arrived lists the newest accounts with their status and the date they joined, and Lately shows the latest entries from the audit log, with a link to The whole log. The foot of the page gives the version that’s running and its newest database migration.
The Users tab lists every account, 50 to a page, with sign-ups waiting for approval first. Each row shows the person’s name, username and email, their status (active, pending or suspended, plus admin and address not confirmed where they apply), how many tomes they have, when they joined and when they were last seen.
Search by name, username or address, or choose Everyone, Waiting, Active or Suspended, and select Go.
A person’s page
Section titled “A person’s page”Select someone to open their page. It shows their address and whether it’s confirmed, when they joined and were last seen, their role and status (with the reason, if they’re suspended), how many sessions they’re signed in with, how much their library holds, and What has happened to the account.
What you can do offers only the actions that fit them now. Every action emails them about it if the site sends email; afterwards, the message says whether that email went, or that you need to tell them yourself.
- Approve: for someone waiting. They can log in straight away. Someone who signed up while email was on can’t be approved until they’ve confirmed their address; the page says so.
- Decline: for someone waiting. They’re told, then the account is removed and the address is free again.
- Suspend: give a reason of 5 to 500 characters. They’re signed out everywhere at once and can’t log in until it’s lifted. The reason is emailed to them and shown when they try to log in. Every Anthology they’ve shared stops opening too, for anyone with the link.
- Lift the suspension: they can log in again, and their shared links come back.
- Make them an admin or Make them a user.
- Reset their password: sends them a link to choose a new one, which works once, for an hour. Nothing changes until they use it.
- Delete: lists what the account holds. Type their username, choose whether to keep Keep the username reserved, so nobody else can claim it and be mistaken for them. ticked, and select Delete the account. Their tomes, reads, Anthologies (and every shared link), authors, series and tags go for good.
If a link can’t be emailed (email is off, their address isn’t confirmed, or sending failed), the page shows it to you once instead. Copy it and pass it on yourself: it isn’t stored anywhere it can be read back.
Your own page says This is you and offers no actions: change your own account in your settings. The site’s only active admin can’t be suspended, demoted or deleted, so a site can’t be left without one.
Making an account
Section titled “Making an account”Open Make an account, enter a Username and Email, optionally tick Make them an admin, and select Make the account. It’s active and confirmed straight away. The same name rules apply as for registering.
Nobody chooses the password, you included. They get an email with a link to choose their own, which lasts 24 hours. If email is off, the link is shown to you once to pass on.
Retired usernames
Section titled “Retired usernames”When someone changes their username, or an account is deleted with its username kept, the name is held so nobody else can take it and quietly start receiving what was shared with the old owner. Retired usernames lists them, with what each became or that the account was deleted. Release frees one for anyone to claim, after you confirm with Release it.
The Audit tab is the site’s record of who did what to an account: every admin action, every password change and reset, change of address, rename and account deletion, sign-ups the housekeeping removed, every site setting a save changed (with its old and new value), and people allowing or disconnecting Forge. It never records an address or a password.
It’s newest first, 50 to a page (Newer and Older). Choose an action under Everything and select Go to see only that kind, or select a name to see only what involves that person.
Genres
Section titled “Genres”Genres are the one list shared by the whole site: people choose from it and can’t add to it. The Genres tab shows each genre as a card with its light and dark colours, how many books carry it and how many spines it colours, and its contrast in each mode.
Each card has:
- Name and Slug.
- Light mode and Dark mode: the genre’s colour in each. Pick one or type a hex value.
- Save. Every spine and pill using it changes colour at once.
- ↑ and ↓ to move it up or down the list people pick from.
- Retire takes a genre out of the picker but leaves it on the books that already carry it. Restore puts it back.
- Delete, only for a genre no book uses, after you confirm with Delete the genre. A genre in use says how many books it’s on, and can be retired instead.
Add a genre takes a name and the two colours. Select Add it to add it at the end of the list.
Each colour is measured against the pale ink stamped on spines and pills. A colour too dark or too light for that ink to read on is refused; one that’s readable but tight saves with its ratio shown beside it.
Unknown is special: it’s the colour a book with no genre falls back to, so it can’t be retired, deleted or have its slug changed. Its name and colours are still yours to change.
Themes
Section titled “Themes”Four themes come with Bibliotome: Sanctum (the default), Verdigris, Nocturne and Vellum. Each card shows the theme’s light and dark colours, its description, how many people have it chosen, and badges for built in, edited, site default and not offered.
- Edit colours opens the theme editor.
- Duplicate makes a copy to start a palette of your own.
- Make it the default sets what new accounts get, and what anyone who hasn’t chosen sees.
The theme editor
Section titled “The theme editor”The editor shows a grid of every text colour against every background, in light and dark, with its contrast ratio. Below that, each mode’s colours are grouped into The page, Ink, Accents, Edges and The shelf. Change what you like and select Save.
A theme has to reach at least 7:1 on every text-and-background pair before it can be offered to anyone. A copy that doesn’t can still be saved, as a draft that isn’t offered yet. The built-in themes are always offered, even while an edit leaves them short.
- Offer this theme to people (copies only) makes it available in everyone’s settings.
- Make it the site default.
- Back to the shipped colours undoes every change to a built-in theme; on a copy, Back to the source’s colours does the same. Confirm with Throw the changes away.
- Delete (copies only), confirmed with Delete the theme. Anyone using it moves to the site default.
A built-in theme can’t be deleted, and its key can’t change; editing one stores your changes on top of the original.
Settings
Section titled “Settings”The Settings tab is one form, saved with Save the settings at the bottom. Everything is checked before anything is saved: if something’s wrong, Nothing was saved. heads the page, each problem is shown beside its field, and what you typed is kept.
What this site is called
Section titled “What this site is called”- Title: the name in the top bar, on every page and in every email. Up to 60 characters.
- Subtitle: one line, in the footer and on the front page.
- Canonical URL: where every Anthology link and every link in an email points. Just the scheme and host, like
https://books.example, with no path and no slash at the end. Setup filled it in with the address the site was first opened on.
What a link to it says
Section titled “What a link to it says”The Description (up to 200 characters) is what a chat app shows when someone pastes a link to the site, with the share image. It’s the same on every page, so a shared Anthology shows the site’s name rather than its own.
The doors
Section titled “The doors”- Registration: one of three choices. Each one’s description changes with whether email is on, because what it does changes too.
- Closed: nobody can make an account, and the site doesn’t offer to.
- Approval: a new account waits for you to approve it on the Users tab. With email on, it confirms its address first, and you hear about it only then.
- Open: with email on, an account is live as soon as its owner follows the confirmation link, which logs them in. With email off, this works as Approval.
- Send email: leave this off until Cloudflare Email Routing is set up for the site’s domain. It can only be switched on with a valid Sending address and Canonical URL. While it’s off, every flow that would send email says plainly that it can’t.
- Sending address: the address emails come from. It has to be one verified in Email Routing, or sending fails.
Name <address@domain>works.
Under Send email, the page tells you what switching it would do before you save. Switching it off moves anyone waiting on a confirmation link into the approval queue, and cancels any change of address that was waiting on its link. Switching it on locks nobody out.
When someone joins the approval queue, every admin gets an email saying so, unless they’ve turned it off in their own settings.
When Bibliotome asks the book catalogues for a book or a cover, it tells them who’s asking: the Canonical URL and the Sending address. Open Library lets a site that gives a contact address make more lookups at once, so fill in the sending address even while email is off.
Sharing
Section titled “Sharing”Allow shared anthologies is the master switch. Off, no Anthology link opens for anyone but its owner, whatever each Anthology is set to. The links are kept, so switching it back on restores every one. While it’s off, owners and the people they’ve shared with see a note saying so.
Sign in to Forge
Section titled “Sign in to Forge”Let people sign in to Forge with and your site’s name lets people use their account here to sign in to Forge, the Dragon’s Lair ticket tracker, the way “Sign in with Google” works. Forge learns their name and email address, and only after they say yes. Enter Forge’s address (a scheme and host with no path) as well. Switching it off stops every sign-in at once, including one already on its way; switching it back on doesn’t ask anybody again. See Signing in to Forge with Bibliotome for what people see.
- Default theme: what new accounts get, and what anyone who hasn’t chosen sees.
- The order a Sanctum stands its halls in: drag the halls, or type their numbers. This is the order everyone starts on; once someone chooses their own in their settings, this no longer changes theirs.
Reserved usernames
Section titled “Reserved usernames”Words that nobody can register as a username, one per line, on top of the ones Bibliotome reserves itself (listed under What this app already reserves). Reserving a name somebody already has doesn’t take it from them; the page warns you if that’s the case.
Test the mail
Section titled “Test the mail”Send a test sends one message to your own address and says what happened. If it says it was sent but nothing arrives, the problem is past Bibliotome: check Email Routing.
The site’s pictures
Section titled “The site’s pictures”Each picture has its own Upload button, separate from Save the settings, and shows what’s in use now:
- Favicon: the tab icon. An SVG stays sharpest.
- Wordmark: the mark beside the site’s name in the top bar. Left empty, it follows the favicon.
- App icon: for an installed app. Square, at least 512 pixels, with anything important inside the middle 80%.
- Share image: the picture on the card when someone pastes a link to the site into a chat. 1200×630 works best. Until you upload one, links show Bibliotome’s built-in card.
Each can be up to 512KB. Go back to the built-in undoes an upload. SVG files are checked, and refused if they carry script or links to other sites.
