How the pieces connect
Proposal
Public at
/proposal/<address> once published. Statuses: draft or published.Agreement
Public at
/contract/<id> once sent. Statuses: draft, sent, signed, countersigned.Invoice
Created in Stripe when sent. Statuses: draft, open, paid, void, uncollectible.
Activity
Views, sends, signatures and payments, on the proposal and in the bell.
Write a proposal
1
Create a draft
In the admin, open Proposals and select New proposal. Enter a Title and the Client (as it should read on the page), then select Create draft. The address is made from the title and shown below it as
/proposal/<address>. The editor shows the same client name as Client label.2
Fill in the editor
Set the Client email (it gets the signed copy), an optional brand kit under Brand kit to theme the page (or None (site accent)), and the Address. Under Opening, write the Intro and What you asked for, then any Sections, Terms (one per line), the Closing line and Valid until (optional).
3
Price the options
Under Packages, each option has a Name, Price, Price note, Timeline, Best for, included items, Revisions and Payment. Add extras under Add-ons and describe the steps after acceptance under What happens next.
4
Publish
Select Publish. A draft is readable at its real address only while you are signed in, so you can preview it first. Unpublish takes it offline again.
Send it to the client
In the Send to client panel, select Copy link to share it yourself, or add an optional Note (optional, goes above the link) and select Send to. The email goes to the address saved on the proposal. Sending requires that:- The proposal is published. Otherwise the panel shows Publish first.
- The client email is saved. Otherwise it shows Add the client email and save.
Acceptance
On the public page the client picks one option under Option accepted (shown when there is more than one), types their name, optionally a title, and selects Accept and sign. An acceptance is recorded once, and a second attempt is refused. Reset acceptance in the Send to client panel clears it. When the client accepts:- The client gets a signed copy by email, and you get a notice.
- The first invoice is drafted from the chosen option’s Payment text. If it contains a percentage, such as
50% to start, the draft is that share of the price and its description ends indeposit. Otherwise it is the full price. If the price has no figure, no invoice is drafted. - Nothing is sent to Stripe or the client yet.
If the client accepted by email or on a call, use the form in the Agreement section of the proposal. Choose Option they chose, fill in Agreed by and How they told you, then select Draft agreement and invoice. No emails go out for an acceptance you record this way.
Draft and sign the agreement
After acceptance, select Draft agreement (or it is drafted for you when you record an acceptance). The agreement takes its scope, price and payment from the chosen option, with the standard terms. While it is a draft you can edit its Title, Send to, parties, scope and clauses, and add a Note with the email (optional).1
Sign and send
Select Sign and send. You sign as the Designer named on the agreement, and the client gets a link to read and sign it. The Send the drafted invoice with it box is ticked by default, so Stripe emails every drafted invoice on the proposal at the same time. Untick it to send the agreement alone.
2
The client signs
On
/contract/<id> the client types their full name, ticks the agreement box and selects Sign agreement. The time and the address the request came from are recorded with the name.3
Executed copy
Once both signatures are on it, the status reads Signed by both and the executed copy is emailed to the client and to you. If the client signs an agreement that does not carry your signature yet, the status asks you to countersign; select Countersign to complete it.
Invoice and get paid
Invoices live in the proposal’s Invoices section and in the Invoices panel in the admin.- New invoice on a proposal drafts the balance: the chosen option’s price minus every invoice already drafted or sent, not counting void or uncollectible ones.
- A draft row has Amount (USD), What it’s for, Send to and Due in (days). Drafts default to 14 days.
- Send creates the invoice in Stripe, and Stripe emails the client a link to pay. The row then reads Sent, unpaid.
- Void cancels a sent, unpaid invoice and the pay link stops working. A sent amount is not edited: void it and draft another. A draft can be deleted instead.
invoice.paid marks it Paid, invoice.voided marks it Void, invoice.marked_uncollectible marks it Uncollectible, and invoice.payment_failed leaves it open. Each one is added to Activity. The MCP server can also list invoices and save drafts.