Setup guide
Every click from the install button to a published site.
Plan on 30 to 60 minutes. Open one step at a time.
We wrote these steps from Cloudflare’s docs. A button on your screen may have a different name. Steps marked “not yet checked” are the ones we’re least sure of.
Before you start
- Make a free Cloudflare account at
dash.cloudflare.com/sign-upif you don’t have one. No credit card needed. - Make a free GitHub account at
github.com/signup. Cloudflare puts your copy of the site’s code there. - Make up a setup code of at least 12 characters and write it down somewhere safe, like your campaign’s password manager. You’ll type it once to create the first sign-in, and again if you ever lose a phone or change your web address.
- Pick who holds the keys. Use a campaign email for both accounts, so the site stays with the campaign if a volunteer moves on.
1. Install
- Click Install Stump. Cloudflare’s install page opens.
- Sign in to Cloudflare if it asks.
- Connect your GitHub account when Cloudflare asks, and let it create a new repository there. That repository is your copy of the code.
- Cloudflare shows one settings page. You can keep the suggested names. Each name you pick becomes part of your site’s first web address.
- Find the field named
SETUP_CODEand paste in the code you made up. - Click the button at the bottom to create your site. Cloudflare copies the code, sets up storage for your content and signups, and puts the site online. Expect a few minutes. Not yet checked: the button’s exact name and how long it takes.
2. Open your site and sign in
- When the install finishes, Cloudflare shows your site’s address. It ends in
workers.dev. You can find it again under Workers & Pages in your Cloudflare dashboard. - Add
/adminto the end of that address and open it. - Type your setup code.
- Create your sign-in. Your phone or computer asks for Face ID, a fingerprint or your screen lock. You won’t need a password.
Your setup code keeps a stranger from taking over your new site before you sign in. Keep it private.
3. Turn on the spam check
The volunteer form needs Cloudflare Turnstile, a free spam check. It takes about 2 minutes. The Spam check screen in your editor walks you through the same steps.
- In a new tab, open your Cloudflare dashboard and go to Turnstile.
- Click Add widget.
- Give it a name, like your campaign’s name.
- Under hostnames, add your site’s address without the
https://. Add your own web address too once you have it. - Leave the mode on Managed and click Create.
- Copy the site key and the secret key, paste both into the Spam check screen and save.
4. Fill in your site and publish
- Open Logo and colors. Add your name, office and state, then upload your logo. The kit picks your colors from it.
- Choose one of the three type styles.
- Go down the list of sections: Opening, About, Issues, Endorsements, Events, Volunteer, Donate and How to vote. Fill in the ones you want and switch off the rest.
- For Donate, paste the link to your campaign’s ActBlue page.
- For How to vote, pick your state. The kit adds the official election links, and you add your own dates.
- Open Contact and footer and add your “Paid for by” line. The kit won’t publish without it.
- Use Preview to check it, then publish.
Describe each photo when the editor asks. Screen readers read that description out loud.
5. Connect your own web address
Optional. Your site already works on its workers.dev address. This is the step that tends to take longest, and you’ll need the login for wherever your domain lives, like GoDaddy or Squarespace.
Move your domain’s settings to Cloudflare
- In your Cloudflare dashboard, open Domains and click Onboard a domain.
- Type your domain, like
riveraforstatehouse.com, and continue. Pick the Free plan. - Cloudflare copies the records it can find. If your campaign email uses this domain, check that its email records came across. Cloudflare says its scan can miss some.
- Cloudflare gives you two nameservers. Copy them letter for letter.
- Sign in at GoDaddy, Squarespace or wherever you bought the domain. If DNSSEC is on there, turn it off first.
- Replace the nameservers with the two from Cloudflare and save.
- Wait. Cloudflare says it can take up to 24 hours, and it emails you when your domain is active.
Point it at your site
- In Cloudflare, open Workers & Pages and click your site.
- Go to Settings, then Domains & Routes, then Add, then Custom Domain.
- Type your domain and click Add Custom Domain.
- Open your site at its new address and go to
/admin. Your old sign-in belongs to the old address, so use your setup code to add a new one. - Add the new address to your Turnstile widget’s hostnames.
6. Invite your team
- Open Team in the editor.
- Make an invite and send the one-time link to your staffer.
- They open it and create their own sign-in with Face ID, a fingerprint or their phone.
Volunteer signups live under Volunteer signups, where staff can download them as a spreadsheet (CSV).
Later: updates and lost phones
Lost phone
Go to your site’s /admin address, type your setup code and create a new sign-in.
Updates
Updates aren’t automatic. Your copy of the code sits in your GitHub, and you pull a new version into it when you want one.
Step-by-step update instructions coming soon
Your state’s rules
This guide isn’t legal advice. Check your state’s rules for campaign websites with your treasurer.