Adronis Portal
The internal side of adronis.app: one page that reads the same Supabase
database the customer site uses, and changes the commercial part of an
account — plan, trial end, next charge, discount.
Every trial and paid plan is a Paddle subscription. Paddle is where it is
charged, and the site's paddle Edge Function mirrors it onto the account.
So the portal never writes billing into the database as if a customer had
paid: a change to a paying account is made in Paddle, through that same Edge
Function, and the account follows from Paddle's answer.
It is a separate site. Nothing in the Adronis repository imports from here,
and nothing here is served from adronis.app.
What it can and cannot do
Can
- List every account with its plan, status, discount, monthly revenue and dates
- Change a paying account in Paddle: move a trial's end, end a trial and
charge today, move the next charge, switch plan from the next charge, cancel
- Give a plan away for good: full access, no renewal date, never charged — the
Paddle subscription behind it, if any, is cancelled first
- Put a per-account discount on the Paddle subscription, with the note
explaining it
- Keep a private internal note per account
- Show what Paddle actually collected in the last 30 days, and each invoice
- Sign itself out after half an hour with nobody touching it
- Show what the account filled in — the business brief — read only
- Show what broke in visitors' browsers on the site (Errors, sent by the
site's
errors.js), copy one out to fix it, and clear it once the fix is live
- Show who changed what, and when
- Open the site's control room or Approvals as a tester sees them, read only
(View as tester in the drawer and under Beta → Health; sign in on the
site once with your admin login)
- Say how each tester is doing over the last two weeks (Beta → Health:
green, yellow or red, and why)
- Set how many beta places there are (Beta → Applications); once they are
all taken the site says the beta is full and takes no applications
- Flag a tester whose ads cost more than a weekly cap (Beta → Costs, and
Today) - to us only - and pause or resume the ad engine for one account
- Put every tester's feedback on the ads in one place - reasons, their own
notes, text they rewrote, their "never" lists - and copy it for the
engine's prompts (Ads → What to fix)
- Answer the Inbox with ready-made emails (Reply…)
Cannot
- Start a trial or a paid plan. Those start at checkout, where Paddle takes the
card; a plan set in the database with nobody charging for it would just be a
free plan wearing a price.
- Write billing fields by hand. Advanced shows every one of them, read only.
- Change the trial length. It is 7 days, set on the Paddle trial prices and
written into the site's copy, so it is changed there.
- Edit the business brief, or anything else the customer owns
- Delete an account, or anything the customer made
- Add or remove its own admins — that is done in the Supabase SQL editor
The plan editor
Open any account and the first thing in the drawer is one sentence saying where
that account stands, then five buttons for where it should stand. Each one asks
only for what it needs, and a line underneath spells out what pressing Apply
will leave behind before you press it. Anything that charges the card or takes
the plan away asks first.
An account that pays through Paddle
The drawer says Pays through Paddle with the subscription and customer IDs,
and Apply goes to the Edge Function (admin_set_plan):
| What happens in Paddle |
|---|
| Trial | Only while Paddle still has it on trial: the trial end moves to the new date. A paying account can't go back on a trial. |
| Paying | On a trial: the trial ends and the card is charged today. Already paying: the next charge moves to the date you pick, and the days in between are free. |
| Beta | Refused: a beta tester never pays. Set No plan first, then Beta. |
| Free forever | The Paddle subscription is cancelled today, then the account is given the plan for good (below). |
| No plan | Paddle cancels at the end of the period, or today. |
A plan or cycle switch is billed from the next charge, the same as when the
customer switches on their own account page. If the customer already has a
switch waiting, the editor opens on that plan, so Apply doesn't undo it.
An account with no running Paddle subscription
Only Beta, Free forever and No plan do anything; all three go
through admin_set_plan_state, which refuses trials, paid plans, and any
account Paddle is billing. Trial and Paying say to send the customer to
checkout.
The Beta plan
Beta is for the businesses picked for the beta, until the public launch in
Q1 2027. It is a plan of its own (plan = 'beta') with no price: it isn't in
the pricing section or at checkout, Paddle has no price for it, and this button
is the only way an account gets it. Underneath it is the same as free forever —
active, no renewal date, never charged, comped, with Beta tester as the
reason unless you write another — so the site lets the account in and nothing
ever renews or ends it.
It includes what the beta plan promises, and the customer's billing page lists
it: 4 ads every Monday in two versions each, every image checked before the
owner sees it, the approved ads posted for them, holiday drops, reels from
approved ads once they are built, up to 4 channels, and 30% off a monthly plan
for the first 12 months after the beta (the FOUNDER30 code in Paddle).
Beta testers have their own tile on the overview and are left out of
Free forever. At launch, set each one to No plan and send them to
checkout with the founder code.
It needs the beta value the site's supabase/schema.sql adds to plan_tier,
so run that file before this one.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
