CHANGELOG.md
... ...
@@ -0,0 +1,79 @@
1
+# Changelog
2
+
3
+A running history of business-rule and workflow changes to Pageant Pass. For a plain-language summary of everything in the v2.0 launch, see [What's New in Pageant Pass v2.0](pages/release-v2.md).
4
+
5
+---
6
+
7
+## 2026-07-02 — Digital payment links can require a verification or promo code
8
+
9
+**What changed:** Directors can now add multiple digital payment links (Venmo, PayPal, CashApp, etc.) to a single competition instead of just one, and each link can carry an optional verification or promo code that Delegates must reference when paying. Delegates see the code inline on the application form, or can reveal it with a tap when browsing competitions before applying.
10
+
11
+**Why:** Some digital payment services (like Venmo) ask the payer to enter a matching code to verify the payment, and Directors sometimes accept more than one payment service.
12
+
13
+**Impact:** Directors configuring payment methods in [Creating a Competition](pages/creating-a-competition.md); Delegates paying entry fees in [Applying to a Competition](pages/applying-to-a-competition.md).
14
+
15
+---
16
+
17
+## 2026-07-02 — "Preview Application" added to the competitions list
18
+
19
+**What changed:** Directors can open a read-only preview of a competition's public signup form directly from the actions menu on the My Competitions list, without leaving the page.
20
+
21
+**Impact:** Directors managing competitions from [Creating a Competition](pages/creating-a-competition.md).
22
+
23
+---
24
+
25
+## 2026-07-02 — Optional a-la-carte competitions on applications
26
+
27
+**What changed:** Some programs can now offer one or more optional, paid add-on competitions (for example Photogenic or a specific talent category) that applicants select and pay for during registration, each with its own price and a maximum number of entries. The price is locked in at the time of application so a later price change doesn't affect past applications.
28
+
29
+**Impact:** Delegates during application — see [Applying to a Competition](pages/applying-to-a-competition.md). This is configured at the program level, not by individual Directors.
30
+
31
+---
32
+
33
+## 2026-07-01 — Compliance "Volunteers" tab now shows a contact roster
34
+
35
+**What changed:** The Volunteers tab on the Compliance page, previously a "coming soon" placeholder, now displays a live roster of judges, auditors, and the emcee with clickable phone and email contacts, pulled from the competition's Event Team details. Auditors and the emcee now support phone/email fields, and up to 2 auditors are supported per competition.
36
+
37
+**Impact:** Directors and anyone holding a compliance link — see [Compliance Tracking](pages/compliance-tracking.md) and [Using a Secure Compliance Link](pages/using-a-compliance-link.md).
38
+
39
+---
40
+
41
+## 2026-07-01 — Optional Year of Service Agreement upload (Miss America)
42
+
43
+**What changed:** Directors running a Miss America competition can upload a blank Year of Service Agreement and mark it required or optional. When configured, applicants see a download link for the blank agreement and an upload slot to return their signed copy as part of Required Documents.
44
+
45
+**Impact:** Directors setting up a Miss America competition; Delegates applying — see [Creating a Competition](pages/creating-a-competition.md) and [Applying to a Competition](pages/applying-to-a-competition.md).
46
+
47
+---
48
+
49
+## 2026-07-01 — Talent description now asks for microphone type
50
+
51
+**What changed:** The Talent Description field on the application form now prompts Delegates to include their microphone preference (lav, stand, headset, or handheld) alongside talent type, duration, music, and props.
52
+
53
+**Impact:** Delegates filling out [Applying to a Competition](pages/applying-to-a-competition.md); Directors planning sound for talent segments.
54
+
55
+---
56
+
57
+## 2026-06-30 — Competition Dashboard "Script" tab renamed to "Event Team"
58
+
59
+**What changed:** The Plus-only "Script" tab on the Competition Dashboard is now labeled "Event Team." It still builds the run-of-show script and generates the judge's book PDF, and judges now also support phone/email contact fields alongside the new auditor roster.
60
+
61
+**Impact:** Directors on the Plus plan — see [Judge's Book & Script](pages/judges-book-and-script.md) and [Competition Dashboard](pages/competition-dashboard.md).
62
+
63
+---
64
+
65
+## 2026-06-30 — Terminology: "unaffiliated" competitions are now called "independent"
66
+
67
+**What changed:** Competitions not tied to a national program are now labeled "independent" instead of "unaffiliated" in competition search and the director dashboard.
68
+
69
+**Impact:** Public-facing search copy and director dashboard labels.
70
+
71
+---
72
+
73
+## 2026-06-29 — Public terminology: "Delegate" renamed to "Candidate"
74
+
75
+**What changed:** User-visible text across the app now says "Candidate" instead of "Delegate" (for example, "Candidate Dashboard"). Internal role identifiers, route paths, and TypeScript variable names are unchanged, and Miss America's own "Miss America Opportunity Delegate" program title is unchanged since that's their own trademarked term.
76
+
77
+**Why:** To keep the platform organization-agnostic — some programs use "Delegate" as their own trademarked term for state representatives, and using it platform-wide risked confusion with organization-specific branding.
78
+
79
+**Impact:** All public-facing app copy. This manual still uses "Delegate" throughout and has not yet been updated to match — flagged as a follow-up.
pages/applying-to-a-competition.md
... ...
@@ -52,7 +52,7 @@ Fill in your own details. To complete this section:
52 52
3. Choose your **Competition Age Division** — **Miss** or **Teen**.
53 53
4. Enter your **Email Address**.
54 54
5. Enter your **Phone Number**.
55
-6. Optionally, add a **Talent Description** to describe your talent performance.
55
+6. Optionally, add a **Talent Description** to describe your talent performance — include the type of talent, duration, music, props, lighting needs, and your microphone preference (lav, stand, headset, or handheld) so the director can prepare for your segment.
56 56
7. Optionally, note any **Dietary Restrictions** so the director can plan for your needs.
57 57
58 58
---
... ...
@@ -75,15 +75,27 @@ Upload the documents the competition requires. To add each one:
75 75
2. Upload your **Community Service Initiative** as a PDF.
76 76
3. Upload your **Headshot** as a JPG or PNG.
77 77
4. Upload your **Talent Music** as an MP3 if you have one (this is optional).
78
-5. To replace a file, remove it and add the new one in its place.
78
+5. If the competition requires a **Year of Service Agreement**, click the **Download the Year of Service Agreement** button to get the blank document, sign it, then upload your signed copy here.
79
+6. To replace a file, remove it and add the new one in its place.
79 80
80 81
Each file can be up to 10MB, and only the file types listed for each upload are accepted.
81 82
82 83
---
83 84
85
+## Optional Competitions
86
+
87
+Some competitions let you enter one or more optional, paid add-on competitions — for example Photogenic or a specific talent category — for an extra fee. If any are offered, you'll see them listed with their price and a quantity selector.
88
+
89
+1. Find the **Optional Competitions** section on the form.
90
+2. For each one you'd like to enter, choose a quantity (up to the limit shown for that competition).
91
+3. The price for each optional competition you select is added to your **Registration Payment** total.
92
+4. Leave the quantity at zero to skip an optional competition.
93
+
94
+---
95
+
84 96
## Registration Payment
85 97
86
-This section shows your entry fee and how the competition accepts payment — for example cash, check, a digital payment link, or online payment. Review the amount and the available payment methods, and follow the on-screen option that applies to you.
98
+This section shows your entry fee — including any [optional competitions](#optional-competitions) you selected — and how the competition accepts payment, for example cash, check, a digital payment link, or online payment. If the director's digital payment link requires a verification or promo code, it appears next to the payment button; make sure to include it when you send your payment. Review the amount and the available payment methods, and follow the on-screen option that applies to you.
87 99
88 100
---
89 101
pages/competition-dashboard.md
... ...
@@ -33,10 +33,10 @@ Below the summary cards is a row of tabs. Each tab opens a different tool for yo
33 33
2. **Notes** — keep private notes and review event details like talent and dietary needs. See [Event Notes](event-notes.md).
34 34
3. **Compliance** — track each contestant's required steps and share secure links with helpers. See [Compliance Tracking](compliance-tracking.md).
35 35
4. **Interview Planner** — build an interview schedule for judging day. See [Interview Planner](interview-planner.md).
36
-5. **Script** — build the run-of-show for your judge's book. See [Judge's Book & Script](judges-book-and-script.md).
36
+5. **Event Team** — build the run-of-show for your judge's book and keep a contact roster for your judges, emcee, and auditors. See [Judge's Book & Script](judges-book-and-script.md).
37 37
6. **Results** — record placements and awards after the competition. See [Recording Results](recording-results.md).
38 38
39
-> **⭐ Plus feature** — Compliance, Interview Planner, and Script are available on the Plus plan. See [Plans & Upgrading](plans-and-upgrading.md).
39
+> **⭐ Plus feature** — Compliance, Interview Planner, and Event Team are available on the Plus plan. See [Plans & Upgrading](plans-and-upgrading.md).
40 40
41 41
---
42 42
pages/compliance-tracking.md
... ...
@@ -36,6 +36,12 @@ At the top of the tracking table, summary cards show your progress at a glance:
36 36
37 37
---
38 38
39
+## The Volunteers tab
40
+
41
+Next to the compliance tracking table is a **Volunteers** tab that lists contact details for the competition's judges, emcee, and auditors — pulled from whatever you've filled in on the [Event Team tab](judges-book-and-script.md). Each entry shows a clickable phone number and email address, so anyone with access to this page (you or a helper with a compliance link) can reach the right person quickly. Fill in phone and email details on the Event Team tab if you'd like them to show up here.
42
+
43
+---
44
+
39 45
## Sharing a secure link with a helper
40 46
41 47
If a field director, state director, or other helper needs to check off compliance, you can send them a secure link. They can view and update compliance without creating a Pageant Pass account — what they see is described in [Using a Secure Compliance Link](using-a-compliance-link.md).
... ...
@@ -63,6 +69,7 @@ Existing links appear on the **Compliance** tab, each showing the contact's name
63 69
|------|-------------|
64 70
| [Competition Dashboard](competition-dashboard.md) | The hub that holds the Compliance tab |
65 71
| [Managing Applications](managing-applications.md) | Review applicants and their acknowledgements |
72
+| [Judge's Book & Script](judges-book-and-script.md) | Enter judge, emcee, and auditor contact details that appear on the Volunteers tab |
66 73
| [Plans & Upgrading](plans-and-upgrading.md) | Compliance tracking is a Plus feature |
67 74
| [Using a Secure Compliance Link](using-a-compliance-link.md) | What a helper sees when they open a link you share |
68 75
| [Glossary](glossary.md) | Plain-language definitions of pageant terms |
pages/creating-a-competition.md
... ...
@@ -12,6 +12,8 @@ You create and edit competitions from the **My Competitions** page. The form ope
12 12
2. To start a brand-new competition, click **Create New Competition** near the top-right of the page.
13 13
3. To change one you already have, click that competition in the list. The same panel opens with its details filled in, ready to edit.
14 14
15
+Each competition in the list also has an actions menu with **Share Registration Link** (copies the public application link to your clipboard) and **Preview Application**, which opens the public signup form for that competition in a new tab so you can see exactly what applicants see without leaving the list.
16
+
15 17
---
16 18
17 19
## Status: Make Your Competition Live
... ...
@@ -73,7 +75,7 @@ This section sets the ways Delegates can pay their entry fee. Turn on each metho
73 75
74 76
1. Turn on **Cash** to accept cash payments.
75 77
2. Turn on **Check** to accept payment by check.
76
-3. Turn on **Digital (Venmo, PayPal, etc.)** to accept payment through a service like Venmo or PayPal. When you turn this on, a link field appears — paste the web link where Delegates should send payment.
78
+3. Turn on **Digital (Venmo, PayPal, etc.)** to accept payment through services like Venmo, PayPal, or CashApp. When you turn this on, you can add one or more payment links — click **Add Payment Link** for each service you accept, choose its type, and paste the web link where Delegates should send payment. You can optionally give a link a custom label, and add a **verification or promo code** the Delegate must reference (for example, the last 4 digits of your phone number for Venmo). If you add a code, choose whether to label it a **Verification Code** or a **Promo Code** — this is what Delegates will see next to the code.
77 79
4. Turn on **Square Invoicing** to collect entry fees online through [Square](glossary.md). You must connect your Square account first — see [Accepting Payments with Square](accepting-payments-with-square.md).
78 80
79 81
> **⭐ Plus feature** — Square payments are available on the Plus plan. See [Plans & Upgrading](plans-and-upgrading.md).
... ...
@@ -82,6 +84,16 @@ This section sets the ways Delegates can pay their entry fee. Turn on each metho
82 84
83 85
---
84 86
87
+## Year of Service Agreement (Miss America Only)
88
+
89
+If your competition is part of the Miss America system, you can require applicants to sign and return a Year of Service Agreement as part of their application.
90
+
91
+1. Turn on **Require applicants to return a completed agreement** if applicants must upload a signed copy before their application is complete. Leave it off to make the upload optional.
92
+2. Under **Blank Agreement PDF**, upload the blank agreement document. Applicants will see a download link for this exact file on their registration form, alongside an upload slot to return their signed copy.
93
+3. To replace the file, remove it and upload a new one in its place.
94
+
95
+---
96
+
85 97
## Early Registration (Optional)
86 98
87 99
You can offer a reduced entry fee for Delegates who apply before an earlier cutoff. This is optional — but if you use it, you must set both fields together.
pages/glossary.md
... ...
@@ -38,6 +38,8 @@ Plain-language definitions of the pageant and Pageant Pass terms used throughout
38 38
39 39
**Title classification** — A tag a Director assigns to each title on a dual-title competition to say what kind of title it is: **Open**, **Closed**, **Collegiate**, or **Festival**.
40 40
41
+**Optional competition** — An a-la-carte add-on competition (such as Photogenic or a specific talent category) some programs offer for an extra per-entry fee. Applicants select a quantity during their application. See [Applying to a Competition](applying-to-a-competition.md).
42
+
41 43
---
42 44
43 45
## Age Divisions
... ...
@@ -64,13 +66,15 @@ Plain-language definitions of the pageant and Pageant Pass terms used throughout
64 66
65 67
**Acknowledgements** — Checkboxes a Delegate confirms when applying: that they've acknowledged the contract, completed Miss America registration, and paid the local fee.
66 68
69
+**Year of Service Agreement** — A Miss America program document a Director can require applicants to sign and return during their application. See [Creating a Competition](creating-a-competition.md) and [Applying to a Competition](applying-to-a-competition.md).
70
+
67 71
---
68 72
69 73
## Judging & Results
70 74
71 75
**Judge's book** — A combined PDF of all contestants' fact sheets and CSI documents, in competition order, for the judges to review. See [Exporting Paperwork](exporting-paperwork.md).
72 76
73
-**Script** — The run-of-show document for the judge's book, organized into sections with judges and sponsors listed. See [Judge's Book & Script](judges-book-and-script.md).
77
+**Script** — The run-of-show document for the judge's book, organized into sections with judges and sponsors listed, built from the **Event Team** tab. See [Judge's Book & Script](judges-book-and-script.md).
74 78
75 79
**Flashcards** — A tool that shows contestant headshots so judges can learn faces, then flips to reveal names and details. See [Flashcards](flashcards.md).
76 80
... ...
@@ -92,6 +96,8 @@ Plain-language definitions of the pageant and Pageant Pass terms used throughout
92 96
93 97
**Square** — A payment service Pageant Pass connects to so Directors on the Plus plan can collect entry fees online. See [Accepting Payments with Square](accepting-payments-with-square.md).
94 98
99
+**Digital payment link** — A web link a Director adds for a service like Venmo, PayPal, or CashApp so Delegates can pay their entry fee directly. A link can optionally require a verification or promo code the Delegate must reference when paying. See [Creating a Competition](creating-a-competition.md).
100
+
95 101
**Watchlist (bookmark)** — A saved list of competitions a Delegate is interested in. See [Finding Competitions](finding-competitions.md).
96 102
97 103
---
pages/judges-book-and-script.md
... ...
@@ -1,6 +1,6 @@
1 1
# Judge's Book & Script
2 2
3
-The **Script** tab builds the run-of-show document that goes with your [judge's book](glossary.md) — the spoken introductions, judge biographies, titleholders, and sponsor acknowledgements that guide your event from start to finish. You fill in each part of the script, then generate a finished PDF you can hand to your emcee. When you're ready to produce the combined contestant book itself, see [Exporting Paperwork](exporting-paperwork.md).
3
+The **Event Team** tab builds the run-of-show document that goes with your [judge's book](glossary.md) — the spoken introductions, judge biographies, titleholders, and sponsor acknowledgements that guide your event from start to finish. It also keeps a contact roster for your judges, emcee, and auditors that a helper can look up from a shared [compliance link](compliance-tracking.md). You fill in each part of the script, then generate a finished PDF you can hand to your emcee. When you're ready to produce the combined contestant book itself, see [Exporting Paperwork](exporting-paperwork.md).
4 4
5 5
> **⭐ Plus feature** — This is available on the Plus plan. See [Plans & Upgrading](plans-and-upgrading.md).
6 6
... ...
@@ -8,7 +8,7 @@ The **Script** tab builds the run-of-show document that goes with your [judge's
8 8
9 9
## Before You Start
10 10
11
-The Script builder is part of the **Plus** plan. If you don't see the **Script** tab, you'll first need to upgrade — see [Plans & Upgrading](plans-and-upgrading.md). You'll also want your competition's applicants reviewed and in order first; see [Managing Applications](managing-applications.md).
11
+The Event Team tab is part of the **Plus** plan. If you don't see it, you'll first need to upgrade — see [Plans & Upgrading](plans-and-upgrading.md). You'll also want your competition's applicants reviewed and in order first; see [Managing Applications](managing-applications.md).
12 12
13 13
---
14 14
... ...
@@ -17,7 +17,7 @@ The Script builder is part of the **Plus** plan. If you don't see the **Script**
17 17
The Script builder lives on your competition's control center.
18 18
19 19
1. Open the competition you're working on to reach its [Competition Dashboard](competition-dashboard.md).
20
-2. Click the **Script** tab near the top of the page.
20
+2. Click the **Event Team** tab near the top of the page.
21 21
3. Wait a moment for your script details to load.
22 22
23 23
---
... ...
@@ -27,8 +27,9 @@ The Script builder lives on your competition's control center.
27 27
The top of the script covers who is on the microphone and who is being introduced.
28 28
29 29
1. In the **Emcee & Judge's Chair** card, type your host's name in **Emcee Name**.
30
-2. Type the name of the person chairing the judges in **Judge's Chair Name**.
31
-3. In the **Current Titleholders** card, fill in **Current Teen Titleholder** and **Current Miss Titleholder** so they can be welcomed during the show.
30
+2. Optionally, fill in **Emcee Phone** and **Emcee Email** so helpers with a compliance link can reach your emcee — see [Using a Secure Compliance Link](using-a-compliance-link.md).
31
+3. Type the name of the person chairing the judges in **Judge's Chair Name**.
32
+4. In the **Current Titleholders** card, fill in **Current Teen Titleholder** and **Current Miss Titleholder** so they can be welcomed during the show.
32 33
33 34
---
34 35
... ...
@@ -40,8 +41,22 @@ Each judge you add gets an introduction in the finished script. You can add up t
40 41
2. Click **Add Judge** at the top-right of that card. (The button shows how many you've added, such as "Add Judge (2/5).")
41 42
3. In the new judge block, type the judge's full name in **Name**.
42 43
4. Type the introduction you'd like read aloud in **Biography**.
43
-5. Repeat for each judge. You'll need at least four judges for a complete script.
44
-6. To remove a judge, click the trash-can button at the top-right of that judge's block.
44
+5. Optionally, fill in the judge's **Phone** and **Email** so helpers with a compliance link can reach them.
45
+6. Repeat for each judge. You'll need at least four judges for a complete script.
46
+7. To remove a judge, click the trash-can button at the top-right of that judge's block.
47
+
48
+---
49
+
50
+## Adding Auditors
51
+
52
+Auditors don't appear in the script itself, but adding them here makes their contact details available to anyone you share a compliance link with. You can add up to 2.
53
+
54
+1. Find the **Auditors** card.
55
+2. Click **Add Auditor** at the top-right of that card. (The button shows how many you've added, such as "Add Auditor (1/2).")
56
+3. Type the auditor's full name in **Name**.
57
+4. Optionally, fill in their **Phone** and **Email**.
58
+5. Repeat for a second auditor if you have one.
59
+6. To remove an auditor, click the trash-can button at the top-right of that auditor's block.
45 60
46 61
---
47 62
... ...
@@ -95,7 +110,7 @@ This script is a companion to the [judge's book](exporting-paperwork.md) itself
95 110
| Page | Description |
96 111
|------|-------------|
97 112
| [Exporting Paperwork](exporting-paperwork.md) | Download the judge's book packet that the script accompanies |
98
-| [Competition Dashboard](competition-dashboard.md) | The control center where the Script tab lives |
113
+| [Competition Dashboard](competition-dashboard.md) | The control center where the Event Team tab lives |
99 114
| [Managing Applications](managing-applications.md) | Review applicants and set competition order before building the script |
100 115
| [Plans & Upgrading](plans-and-upgrading.md) | The Script builder is a Plus plan feature |
101 116
| [Glossary](glossary.md) | Definitions of judge's book, script, and other terms |
pages/using-a-compliance-link.md
... ...
@@ -40,7 +40,7 @@ Your name is recorded as the person who verified each step. Resting your pointer
40 40
41 41
## The Volunteers Tab
42 42
43
-You'll also see a **Volunteers** tab next to **Delegates**. Volunteer management isn't available yet, so there's nothing to do there for now — stick to the **Delegates** tab.
43
+You'll also see a **Volunteers** tab next to **Delegates**. It lists contact details for the competition's judges, emcee, and auditors — whichever the Director has filled in. Each row shows a name with clickable phone and email links so you can reach them directly. If the Director hasn't entered any volunteer details yet, this tab is empty.
44 44
45 45
---
46 46
... ...
@@ -49,6 +49,7 @@ You'll also see a **Volunteers** tab next to **Delegates**. Volunteer management
49 49
| Page | Description |
50 50
|------|-------------|
51 51
| [Compliance Tracking](compliance-tracking.md) | How Directors track compliance and create the link you received |
52
+| [Judge's Book & Script](judges-book-and-script.md) | Where Directors enter judge, emcee, and auditor contact details |
52 53
| [Glossary](glossary.md) | Plain-language definitions of pageant and Pageant Pass terms |
53 54
| [Home](Home.md) | The full table of contents for this manual |
54 55