Administration
This page is for the person who runs a Get Sh*t Done site. Admins get an Admin item in the account menu, which opens five tabs: Dashboard, Users, Themes, Settings and Audit. Anyone else who finds the address sees an ordinary “nothing here” page.
Being an admin isn’t a key to anybody’s tasks. Every admin page shows counts, never a title, a note or a tag, and there’s no admin view of anyone’s list. You never choose, type or see anybody’s password either.
Setting up a new site
Section titled “Setting up a new site”A new site has no accounts, and until it has one, every address goes to Set up Get Stuff Done. Enter Your name, Email, a Password of at least 12 characters and your Time zone (guessed from where you are), and select Create the admin account. That first account is the admin, and you’re signed in straight away.
Setting up also records the address you used as the site’s Site URL, which every email link uses, so it has to start https:// (plain http:// only works on your own computer). You can change it in Settings.
Once setup has run, the setup page is gone for good, even if every admin account is later lost. The app’s README gives the command that makes an existing account an admin in that case.
A new site starts with registration Closed and email off. Go through Settings before inviting anyone.
Dashboard
Section titled “Dashboard”The tiles count People (and how many are active), Waiting for approval (highlighted when anyone is), Suspended, and, across everyone, Open tasks and Done, last 30 days.
Under Waiting for approval is everyone who has signed up, confirmed their address if the site sends email, and is waiting for you, each with Review, which opens their page. Someone who hasn’t confirmed their address yet isn’t counted here.
Four health cards say whether the parts that run without you 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 (digests, recaps, reminders and account emails), how many failed, and why the last one failed.
- Scheduler: when the background job last ran. It should run every minute; if it hasn’t for three, the card says something has stopped it. If the last run had a step that failed, the card says Failing and names the step and what went wrong. It also counts reminders sent in the last 24 hours, and digests sent or skipped because nothing was due.
- Push: how many devices have push turned on, and how many subscriptions the browsers had expired and were removed this week. Not set up means the site’s push keys haven’t been added; until they are, reminders go in-app and by email only.
- Housekeeping: how many deleted tasks are waiting out their days before they’re removed for good. It runs every quarter of an hour by itself; Run housekeeping now runs it straight away.
Below the cards:
- Storage: how much space the site’s own images take. They’re the only files Get Sh*t Done keeps.
- Lately: the newest entries in the audit log, with a link to the whole log.
- The version that’s deployed, when, and the newest database migration.
The Users tab lists every account, with its badges (Admin, and Active, Waiting or Suspended, plus Address not confirmed while email is on), how many open tasks it has, and when it was last seen. People waiting for you come first, then everyone by name, 50 to a page.
- Search by name or email.
- Filter by status: Any, Active, Waiting or Suspended.
- Select Manage to open one person’s page.
The list only lists. Everything that acts on a person is on their own page, so that thirty rows of buttons aren’t thirty chances to click the wrong one.
Adding a person
Section titled “Adding a person”Open Add a person, enter their Name and Email, tick Make them an admin if you want, and select Add them. The account is ready at once, with its address counted as confirmed. You don’t choose a password: they’re emailed a link to choose their own, which works once, for 24 hours. If email is off, or the email doesn’t go, their page shows you the link instead, once, to pass on yourself. It isn’t shown again; if it’s lost, make them a reset link.
Managing one person
Section titled “Managing one person”A person’s page says whether their address is confirmed and how many devices they’re signed in on, and shows their Open tasks, Done, all time, Repeating and Devices with push, and nothing else of what’s in their account. For an active account:
- Role: Make them an admin… or Make them a user…. An admin can use this panel and act on every account, but can’t see anyone’s tasks.
- Password: Make a reset link… emails them a link to choose a new password, which works once, for an hour. If email is off, their address isn’t confirmed, or the email doesn’t go, the link is shown to you once instead, to pass on some way other than email.
Below that are the ways out, which depend on the account:
- Waiting for their address (someone who signed up but hasn’t followed their confirmation link): they can’t be approved until they have. A sign-up nobody confirms is removed after seven days. You can still Decline… it.
- Approve (someone waiting): 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 their reminders and emails stop. Nothing is deleted. The reason is shown to them when they try to sign in, so write it for them. Lift the suspension lets them back in with everything as it was. The page says when the suspension began.
- Delete…: the page spells out how many open tasks and completions go. Type delete and select Delete everything. It happens straight away, and there’s no undo.
Everything except Approve and Lift the suspension asks first, with Cancel to back out. If email is on, the person is emailed about each of these: being approved or declined, suspended (with your reason) or let back in, made an admin or a user, and deleted. The message after each one says whether that email went, for example Sam is approved, but the email telling them didn’t go. Let them know yourself; the dashboard’s Email card has the reason.
The site always keeps at least one active admin. Making the last one a user, suspending them or deleting them is refused with That’s the only admin. Make someone else an admin first, so the site isn’t left with nobody to look after it.
Your own page acts on nothing. Change your own password and account in Settings.
Audit log
Section titled “Audit log”The Audit tab is a record of every admin action on an account, every password and address change, every account deleted, every site setting changed (with its old and new values), every theme change, and every time someone lets Forge sign them in or disconnects it. Each line says who did what, to whom, and when, with names as they were at the time. Nothing in it is ever deleted, and it never holds a password, a link, or anyone’s email address.
Choose an action under What and select Show to narrow it down, or select a name to see everything about that person. Each person’s page also shows their own entries under In the audit log.
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, and every ring and fill 3:1. 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 (Habanero, Jalapeño and Ghost) ship with the app. You can change their colours, but you can’t delete them or stop offering them. Revert to shipped puts one 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, each with a hint and a Light and a Dark value.
- The contrast checks, which update as you type, with any failing pairs at the top.
- A Live preview of both modes side by side, drawn with the app’s own pieces.
Select Save theme to save. 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.
Delete theme removes a copy, after asking first. Anyone who was using it gets the site default. The default itself can’t be deleted until another theme is the default.
Settings
Section titled “Settings”The Settings tab holds the site’s own settings, a section at a time. A section that can’t be saved comes back with each problem beside its field.
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. If email is on, they confirm their address first, and only then are the admins emailed and the person counted as waiting.
- 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 sign-up page tells people beforehand which of these will happen to them.
Each admin can turn off the email about new sign-ups for themselves, under New sign-ups in their own Settings › Notifications. People waiting still show under Users either way.
Get Sh*t Done 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, as long as it’s confirmed.
The From address has to be one Cloudflare’s Email Routing is set up to send from, and the Site URL has to be set before email can be turned on. The name on outgoing email is always Get Stuff Done, whatever anybody’s voice. Nothing is ever sent to an address nobody has confirmed.
While email is off, everything copes: sign-up falls back to approval, password reset says plainly that it can’t send, and reminders go by push and in-app only.
Turning email off frees everyone waiting on a link that could no longer come, and the card says beforehand how many people that affects. Open sign-ups waiting to confirm wait for your approval instead, sign-ups that were going to need approval go straight to Waiting, and changes of address that are waiting are cancelled.
New accounts start with
Section titled “New accounts start with”The voice (Spicy or Clean) and the daily digest (Off, or On, 7:00 am) that new accounts start with. Everyone can change their own afterwards.
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.
- 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%. Show the crop Android may apply previews it.
- Share image: the picture on the card when someone pastes a link to the site into a chat. 1200 × 630 pixels is the shape every service crops to.
Select Choose…, then Upload. SVG, PNG, JPEG, GIF, WebP and AVIF work, up to 2 MB, and up to 30 uploads an hour. An SVG that carries a script or points at another server is refused. A HEIC picture from an iPhone is refused too, with a note on how to send it as a JPEG. 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. Write it in the Clean voice: everyone sees the same one. It isn’t for search engines, because every page tells them to stay away.
Limits
Section titled “Limits”- Keep deleted tasks for (days): between 1 and 90, 7 to start with. After that, deleted tasks are removed for good. What they earned stays in their owners’ stats.
- Site URL: the address every link in an email uses. It has to start
https://.
Sign in to Forge
Section titled “Sign in to Forge”Forge, the Dragon’s Lair ticket tracker, can let people sign in with their Get Sh*t Done account. This section is where you allow it. Turn on Sign in to Forge, enter Forge’s address (just the address, like https://forge.example.com, with nothing after it), and select Save Sign in to Forge.
When it’s on, Forge can send people here to ask whether it may sign them in. Forge sees their name and email address, once they’ve said yes, and nothing else. Each person can disconnect it in their own Settings. Turned off, Forge’s requests get a “nothing here” page, and any sign-in already on its way stops working.
Fixed on purpose
Section titled “Fixed on purpose”Some things aren’t settings at all:
- Search engines: every page asks not to be indexed. Nothing here is public.
- Sign-in lockout: five failed attempts from one place locks it out for 15 minutes.
- Push keys: set once, when the site is set up. Replacing them would silently break push on every device that has it turned on, so there’s no button for it.
