Administration
This page is for the maintainer. Maintainers get an Admin item in the account menu, which opens Running the forge, with six tabs: Dashboard, Users, Apps, Themes, Settings and Audit. Anyone else who finds the address sees the ordinary page-not-found, which says nothing about what’s there.
There can be more than one maintainer. Every maintainer can triage every ticket, use Admin and act on every account but their own. Forge never lets the last active maintainer be made a member, suspended or deleted.
Anything that can’t easily be undone, such as declining a sign-up, changing someone’s role, making a reset link, suspending, deleting, archiving, or deleting or reverting a theme, asks first, with Cancel beside the button that does it.
Setting up a new Forge
Section titled “Setting up a new Forge”A new Forge has no accounts, and until it has one, every address goes to Set up Forge. Enter Your name, Email and a Password of at least 12 characters, and select Create the maintainer account. That first account is the maintainer, and you’re signed in straight away. Once it exists, the setup page is gone for good, even if every maintainer is later lost.
Setting up also records the address you used as the Site URL, which every link in an email uses. You can change it in Limits.
A new Forge starts with no apps, registration Closed and email off. Add your apps in Apps and go through Settings before inviting anyone.
Dashboard
Section titled “Dashboard”Across the top, the dashboard counts:
- Active tickets, across every app.
- Not yet triaged: open tickets no maintainer has touched yet, with no status change and no comment from one. It says Needs you when there are any.
- Needs info: tickets waiting on the person who filed them.
- People: active accounts, and how many are suspended.
- Waiting for approval: sign-ups waiting for you. It says Needs you when there are any.
Under them:
- New, not yet triaged lists those tickets, most voted first, each with Triage, which opens the ticket. See Triage.
- Waiting for approval lists everyone who has signed up and is waiting, each with Review, which opens their page.
Three health cards say whether the parts that run on their own are working. Each shows its state as a word as well as a colour:
- Email: Off, Working or Failing, with how many emails went in the last 7 days (ticket updates, new-ticket alerts and account emails), how many failed, and why the last one failed.
- Scheduler: when the background job last ran. It sends ticket email every minute, and every quarter of an hour it sends the daily and weekly summaries and does the housekeeping, such as removing sign-ups nobody confirmed. It also counts the summaries sent in the last day, and how many were skipped with nothing new. If it hasn’t run for three minutes, the card says something has stopped it, and if a step failed, it names it. Run housekeeping now runs the housekeeping straight away.
- Storage: how much space screenshots and the site’s own images take.
Lately shows the newest lines from the audit log, with a link to The whole audit log. At the foot is the version of Forge that’s running.
The Apps tab lists every app people can file tickets against, with its active and closed counts and its state: Accepting, Not accepting or Archived. The order here is the order of the index on the ticket list; move an app with its up and down arrows. Archived apps always come after the rest.
Adding an app
Section titled “Adding an app”Select Add an app and fill in:
- Name: what people see, up to 60 characters.
- Link to the app: optional. A whole address, starting
https://. It’s shown at the top of the app’s tickets, so people can go and look. - Description: one line, up to 140 characters. Shown at the top of its tickets and on its tile in the new-ticket form.
Select Add the app. A new app starts accepting tickets, at the foot of the index.
Its address in Forge is made from its name when you add it, and never changes, even if you rename the app later, so links to its list keep working.
Managing one app
Section titled “Managing one app”Select Manage to open an app’s page. It shows its Active and Closed tickets and its Votes, with links to the app and to its tickets. You can change its name, link and description and select Save.
An app is in one of three states:
- Accepting new tickets: the switch is on. It’s offered on the new-ticket form.
- Not accepting: switch Accepting new tickets off. It drops out of the new-ticket form, but its tickets stay open to votes and comments, and you can still triage them.
- Archived: for an app that’s finished or retired. Select Archive… and confirm with Archive. Its tickets stay readable but take no more tickets, votes or comments, and nobody can edit their write-ups.
To undo an archive, select Unarchive. Its tickets open to votes and comments again and it returns to its place in the index, but it won’t take new tickets until you switch Accepting new tickets back on.
You can only delete an app that has no tickets: select Delete… and confirm. An app with tickets can’t be deleted; archive it instead, or move its tickets to another app from their Triage panels first.
Signing in with an app
Section titled “Signing in with an app”Each app’s page has a Sign in with section for that app. It’s what puts the app’s button on the sign-in and sign-up pages, so people can use their account there to sign in to Forge. See Signing in with another app for what they see.
The heading says whether the app is Connected or Not connected. An app has to be connected before you can offer it, which means setting it up on both sides: the app’s own Admin has to have signing in to Forge switched on, with Forge’s address, and Forge has to be deployed knowing about the app. Until then, the section says what’s missing and its switches can’t be turned on. Once it’s connected, it says how many people have linked a login from that app.
- Offer it: a button for the app on signing in and creating an account, and a Link… button in everyone’s Linked logins. Off, nobody can sign in with it, even people who have already linked it.
- Skip approval for its new accounts: with Ask me first, an account made through this app is active at once, rather than waiting for you. Leave it off for an app anybody can join. With registration Closed, the app only signs in people whose login is already linked; it never makes accounts.
- Its icon: the app’s own icon, shown beside its name on the buttons. Select Choose… to upload one: square, and at least 96 pixels. Remove takes it away, and the buttons show the app’s initial instead.
An account made through an app has no password. When an account made this way has to wait for your approval, every maintainer is told, as for any other sign-up.
The Users tab lists every account, with badges for Maintainer, Waiting or Suspended, and Address not confirmed, how many tickets each has filed, when they joined and when they were last seen.
- Search by name or email.
- Filter by status: Any, Active, Waiting or Suspended.
- Select Manage to open one person’s page.
The list shows a page at a time, with the total, and the Users tab shows how many sign-ups are waiting. The list only lists. Everything that acts on a person is on their own page.
Names, tickets and comments are public. Email addresses are not: only maintainers see them, here and on each person’s page.
Adding a person
Section titled “Adding a person”Open Add a person at the foot of the list, enter their Name and Email, tick Make them a maintainer if they should be one, and select Add them. Their account is ready at once, with the address counted as confirmed.
You never choose their password. They’re emailed Forge: an account for you, with a link to choose their own, which works once, for 24 hours. If email is off, or the email doesn’t go, the link is shown to you instead, once, to pass on some other way. It’s never shown again: if it’s lost, make a reset link from their page.
Managing one person
Section titled “Managing one person”A person’s page shows their address, whether it’s confirmed, when they joined and were last seen, when a suspension began, and how many devices they’re signed in on. Then their Tickets filed, Comments, Votes and Following.
Signs in with lists how they sign in: A password, and any app logins they’ve linked, with when each was linked and last used. It’s there to look at only: linking and unlinking are theirs alone. An account with no password was made through an app; a reset link still works for it, and sets a password.
For an active account:
- Role: Make them a maintainer… or Make them a member…, then confirm. A maintainer can triage every ticket, see Admin and act on every account. A member can file tickets, vote and comment, and edit their own tickets. They’re emailed about the change.
- Password: Make a reset link…, then Make the link. You never choose, type or see anybody’s password. The link goes to them by email; if email isn’t working, it’s shown to you once to pass on. It works once, for an hour.
Below that are the ways out, which depend on the account:
- Waiting on their link (someone who has signed up but not yet confirmed their address): there’s nothing to approve yet. Once they’ve opened the link, you can approve them, and you’re told. An address nobody has opened isn’t one to vouch for.
- Approve (someone waiting, with their address confirmed): they can sign in, and if email is on, they’re emailed to say so.
- Decline… (someone waiting): removes the sign-up, and if email is on, tells them it wasn’t approved. They can try again later.
- Suspend… (an active account): type a Reason of at least five characters and select Suspend. They’re signed out at once and can’t sign back in, and emails about tickets stop. Their tickets and comments stay up. The reason is shown to them when they try to sign in, and emailed to them, so write it for them. Lift the suspension lets them back in with everything as it was, and tells them so.
- Delete…: the page spells out how many tickets, comments and votes they have. Type delete and select Delete the account. There’s no undo. They’re emailed to say their account has been deleted.
After each action, a note at the top says what happened, and whether the email telling them went. If it didn’t, for example because email is off or their address isn’t confirmed, it says to let them know yourself.
Lately shows the newest lines about them from the audit log, with a link to everything about them there.
Deleting an account, or removing everything for spam
Section titled “Deleting an account, or removing everything for spam”Deleting an account normally keeps the person’s tickets and comments, credited to A deleted account, and removes their votes and follows.
For spam, tick Remove their tickets and comments too before you delete. Then:
- Their tickets are deleted, with every screenshot on them, including any that other people added in comments, and the votes other people gave them.
- Any other ticket that had been merged into one of theirs is split back out, with its votes, and reopened.
- Their comments on other tickets leave the line Removed by the maintainer, and any screenshots that came with those comments are deleted.
Your own page says This is you and acts on nothing, so Forge can’t be left without a maintainer by accident. Change your own password and account in Settings.
Themes
Section titled “Themes”Every text colour in a theme has to reach a contrast of 7:1 against every background it sits on, in light and dark mode. The Themes tab is where you edit the built-in themes and make your own.
Each theme has a card with its colours, its key, how many people use it, and whether it’s the default or not offered. Each card has Edit and Duplicate.
- The three built-ins (Cyanotype, Vandyke and Diazo) ship with the app. You can change their colours, but you can’t delete them or stop offering them. An edited one has an edited badge, and Revert to shipped puts it back exactly as it came.
- Duplicate makes a separate copy with a key guessed from the original, and opens it for editing straight away. A copy never changes underneath you when its source does; Revert to source copies the source’s current colours back in.
The editor
Section titled “The editor”The editor opens beneath the cards, with:
- Name and Description. A copy also has a Key, the name in its stylesheet’s address. Changing it keeps everyone who’s using the theme on it.
- Every colour, grouped under Grounds, Text, Text on fills and Lines, each with a hint and a Light and a Dark value.
- The contrast checks, which update as you type, with any failing pairs first. Show every pair, both modes lists them all.
- A Live preview of both modes side by side, drawn with Forge’s own ticket row and buttons.
Select Save theme to save, then Done. A theme with a failing pair still saves, so you can come back to a palette in progress, but it can’t be offered to people until every pair passes.
Under Availability:
- Offer this theme to people puts it in everyone’s Appearance settings. It’s blocked until every pair passes.
- Make it the site default makes it what new accounts, and everyone who hasn’t picked a theme, see. Only an offered theme can be the default. If an edit stops the default theme from being offered, the site default goes back to Cyanotype.
Delete theme… removes a copy, once you confirm with Delete theme. Anyone who was using it gets the site default. The default itself can’t be deleted until another theme is the default. Revert to shipped and Revert to source ask first too, because your changes to the colours are lost.
Settings
Section titled “Settings”The Settings tab, headed Site settings, holds Forge’s own settings, a section at a time. If something in a section is wrong, the message shows beside its field, in that section.
Who can join
Section titled “Who can join”- Closed (the default): nobody can sign up.
- Ask me first: people can sign up, and wait under Users until you approve them. With email on, they confirm their address first, and only then are they waiting for you and are you told.
- Open: people can sign up and start once they’ve confirmed their email address. While email is off, Open works like Ask me first, because there’s no way to confirm an address.
The description beside the choices changes to match whether email is on. Reading never needs an account, whichever you choose. To let people in through another app’s login, see Signing in with an app.
Forge sends email through Cloudflare. Enter a From address, turn on Send outgoing email, and select Save email. Send a test to me then sends one to your own address. Email can’t be turned on without a From address, or without a Site URL that starts https://.
The From address has to be one Cloudflare’s Email Routing is set up to send from. Email always goes out under the name Forge.
While email is off, everything copes: sign-up falls back to approval, password reset says plainly that it can’t send, and nobody is emailed about the tickets they follow, though their inbox still fills. Turning email on doesn’t send a backlog of what happened while it was off.
Turning email off frees everybody waiting on a link that could no longer come. Before you save, the section counts them: sign-ups waiting to confirm on an Open site wait for your approval instead, sign-ups waiting to confirm before approval go straight to Users as waiting, and changes of address that are waiting are cancelled.
New accounts start with
Section titled “New accounts start with”Email about followed tickets: As it happens, Once a day, Once a week or Never, the timing new accounts start with. Everyone can change their own in Notifications.
This site’s own images
Section titled “This site’s own images”Four images, each with a built-in until you upload your own:
- Favicon: the icon in a browser tab. An SVG stays sharp at every size; a PNG should be at least 32 pixels.
- Site icon: the mark beside the name in the top bar. It wants a transparent background. Left as the built-in, the top bar draws Forge’s mark in each person’s theme; an upload looks the same for everybody.
- App icon: what an installed app shows on a home screen. Square, and at least 512 pixels. Android crops it to a circle or a rounded square, so keep anything that matters inside the middle 80%.
- Share image: the picture on the card when someone pastes a link to Forge into a chat. 1200 × 630 pixels is the shape every service crops to.
Select Choose… to upload one. SVG, PNG, JPEG, GIF, WebP and AVIF work, up to 2 MB. An SVG that carries a script or points at another server is refused. Use the built-in puts the original back. After changing the app icon, an installed app may need removing and adding again before a home screen shows the new one.
Site description
Section titled “Site description”A sentence or two, up to 200 characters, shown on the card a chat app draws for a pasted link, in the pages’ description, and by an installed app. The preview beside it shows how a pasted link looks. Select Save description.
Limits
Section titled “Limits”- Screenshots per ticket or comment: between 1 and 10, 4 to start with. The limit applies to a ticket’s write-up and to each comment separately.
- Largest screenshot (MB): between 1 and 8, 5 to start with. Bigger pictures are scaled down in the browser before they’re sent, so this limits the upload, not the picture.
- Site URL: the address every link in an email uses. Just the address, starting
https://, with nothing after the name.
Select Save limits.
Each member’s screenshots can take up to 100 MB in all; maintainers have no limit.
Fixed on purpose
Section titled “Fixed on purpose”Some things aren’t settings at all:
- Sign-in lockout: 5 failed attempts from one address locks it out for 15 minutes.
- Email addresses: never shown on a public page, and never in an email to anyone but their owner.
- Search engines: every page carries
noindex. Anyone with a link can read a ticket, but tickets don’t turn up in search results.
The Audit tab is the audit log: every action on an account, every password and address change, every account deleted, every login from another app linked or unlinked, and every app, theme and setting changed, with the old and new values. Each line says when, who did it, and to whom. Names are as they were at the time, and nothing in the log is ever deleted. No address or password is ever written in it.
Choose from What to see only one kind of action. Select a name to see only what that person did or had done to them, and Everybody to go back. The log shows 50 lines a page, newest first; Older → and ← Newer move between pages.
