WURU PEACE PULSE
Instructions for Use
====================
Last updated: 23 August 2026
This guide explains how visitors use Peace Pulse and how WURU admins manage
signups, map lights, events, stories, statistics, privacy, and notifications.
1. VISITOR INSTRUCTIONS
-----------------------
Open the Peace Pulse page and use the interactive map to explore participation.
WORLD MAP
- Every country is clickable.
- Click a country to open its states, provinces, or first-level regions.
- The country selector in the map toolbar is an alternative to clicking the map.
- Use the World button to return to the full world map.
UNITED STATES MAP
- Click United States on the world map or use the United States button.
- Click a state to zoom into that state.
- On the U.S. overview, clicking a county also zooms into its state.
- Within a state, click a county to highlight it.
- Use the Back button to return to the states view or world view.
TOWNS AND CITIES
- After choosing a country region, towns and cities load when available.
- Use the town/city search box or click a map point.
- Selecting a mapped town automatically fills the pledge form and saves its
approximate coordinates with the signup.
- Users should never enter coordinates manually.
- If a town is not listed, choose the manual option by typing the town name
directly into the City / town field.
- Manually typed towns are matched to the place dataset when possible.
- Locations use approximate town or city centers, never an exact home location.
KEYBOARD USE
- Press Tab to move through map controls, countries, regions, states, counties,
towns, cities, and map lights.
- Press Enter or Space to activate the focused map item.
- The current map selection is announced for screen-reader users.
SUBMITTING A PLEDGE
1. Enter a name or organization name.
2. Enter a city or town. If it cannot be found, type it manually.
3. Enter a country or territory.
4. Optionally enter a state, province, or region.
5. Optionally enter an email address and select WURU updates.
6. Select Put me on the map.
The form validates required fields and email format. It prevents duplicate
submissions while saving, uses a hidden spam honeypot, and limits repeated
requests. New signups are pending until an admin reviews them.
2. ADMIN CMS WORKFLOW
---------------------
Peace Pulse content is managed in Wix CMS.
Open the Wix dashboard and go to:
CMS -> WURU Peace Pulse
The collection uses these content types:
- light Public map light
- event Gathering or event card
- story WURU story card
- stat Movement statistic
Use the active field to control whether an item is shown. Use orderIndex to
control display order.
MAP LIGHTS
- Add one CMS item with type = light.
- Use latitude and longitude for real-world placement.
- Add city, county, region, and country where available.
- Set active = true for the item to be eligible for display.
- Approved pledge signups are the normal source of new public lights.
- Existing light items should represent approved participation only.
EVENTS
- Set type = event.
- Add title, city, day, month, year, time, label, and link.
- Set featured = true when the event should receive featured styling.
- Set active = true to publish it on the page.
STORIES
- Set type = story.
- Add title, city, summary, label, number, artVariant, and link.
- Supported art variants are one, two, and three.
- Set active = true to publish the story.
STATISTICS
- Set type = stat.
- Add a value and label, such as:
value: 12
label: people keeping the pledge
- The page displays up to four active statistics.
- Do not use a made-up total. Keep the number consistent with approved data.
3. APPROVING PEACE PULSE SIGNUPS
---------------------------------
Open the Wix CMS collection:
WURU Peace Signups
For each new signup:
1. Check the name, city, country, and optional region.
2. Confirm the submission is genuine and appropriate for the movement.
3. Confirm the location is approximate and does not expose a home address.
4. If the signup has no coordinates, add an approximate town/city-center
latitude and longitude when appropriate.
5. Set approved = true only after review.
6. Leave approved = false for pending, unclear, or rejected submissions.
Approved records with valid coordinates appear as map lights. Pending records
do not appear publicly. Do not publish exact residential coordinates.
The signup endpoint records the locationSource field. Typical values are:
- place-selected A visitor selected a mapped town or city.
- manual-place-match A manually typed town matched the place dataset.
- manual-pending No coordinate match was available yet.
4. ADMIN NOTIFICATIONS
----------------------
The signup endpoint saves the CMS record first, then sends an optional admin
notification. Notification failure does not delete or undo the signup.
To activate notifications, configure this private environment variable in the
Wix hosting environment:
WURU_ADMIN_NOTIFICATION_WEBHOOK
The value must be the private URL of a trusted notification receiver or Wix
Automation/webhook workflow. Configure the final admin recipient in that
workflow. Never expose the webhook URL in browser code or public content.
The notification payload identifies the event as:
wuru-peace-pulse-signup
If no webhook is configured, signups still save normally but no notification is
sent.
5. CONTACT, PRIVACY, AND SOCIAL SHARING
---------------------------------------
Public pages:
- /peace-pulse Main Peace Pulse experience
- /privacy Plain-language privacy policy
- /contact Contact page
The public contact inbox is configured in:
src/lib/siteConfig.ts
Change contactEmail there if the published WURU inbox is different from the
current placeholder address. Review the privacy policy with the organisation's
legal adviser before final launch.
The social-sharing image is stored at:
public/social/peace-pulse.png
The site automatically adds Open Graph and Twitter preview metadata. Keep the
image at 1200 x 630 pixels when replacing it.
6. ANALYTICS
-----------
Peace Pulse sends these events through the Wix Analytics SDK:
- ViewContent when the Peace Pulse page is viewed.
- Lead when a pledge is successfully submitted.
- wuru_peace_pulse for country, region, and town selections.
Connect the desired analytics destination in Wix to receive these events.
Do not include email addresses or exact locations in analytics labels.
7. COMMON ADMIN TASKS
---------------------
CHANGE THE CONTACT EMAIL
1. Open src/lib/siteConfig.ts.
2. Replace the contactEmail value.
3. Build and publish the site.
ADD AN EVENT, STORY, OR STAT
1. Open Wix CMS -> WURU Peace Pulse.
2. Add a new item with the correct type.
3. Complete the fields described above.
4. Set active = true and choose an orderIndex.
5. Reload the published page to verify it.
APPROVE A NEW MAP LIGHT
1. Open Wix CMS -> WURU Peace Signups.
2. Review the entry.
3. Add an approximate coordinate if needed.
4. Set approved = true.
5. Reload Peace Pulse and confirm the light appears.
REMOVE A PUBLIC ITEM
- For CMS content, set active = false.
- For a signup, set approved = false.
- Prefer disabling an item instead of deleting it so the admin history is kept.
8. TROUBLESHOOTING
------------------
MAP DATA DOES NOT LOAD
- Refresh the page.
- Check that the hosted files under public/map are present in the published
build.
- Check the browser console for a map request error.
A TOWN IS NOT FOUND
- Ask the visitor to type the town manually in the pledge form.
- An admin can add an approximate city-center coordinate after review.
A SIGNUP DOES NOT APPEAR AS A LIGHT
- Confirm the CMS record is approved = true.
- Confirm latitude and longitude are valid numbers.
- Confirm the record is not filtered out by the active content rules.
- Reload the page after the CMS change.
AN ADMIN DID NOT RECEIVE A NOTIFICATION
- Confirm WURU_ADMIN_NOTIFICATION_WEBHOOK is configured in Wix.
- Check the receiving workflow and its recipient address.
- Check the server logs for [wuru-admin-notification] delivery failed.
- Confirm that the signup record itself exists in WURU Peace Signups.
THE CONTACT LINK IS WRONG
- Update contactEmail in src/lib/siteConfig.ts and publish again.
9. PUBLISH CHECKLIST
--------------------
Before announcing the live site:
[ ] Confirm the contact inbox.
[ ] Review the privacy policy.
[ ] Configure the admin notification webhook or Wix Automation.
[ ] Connect analytics if desired.
[ ] Confirm the CMS collections are admin-accessible.
[ ] Test a signup with a mapped town.
[ ] Test a signup with a manually typed town.
[ ] Confirm pending signups do not appear publicly.
[ ] Approve a test signup and confirm its approximate light appears.
[ ] Test the privacy and contact links on desktop and mobile.
[ ] Test keyboard navigation through the map.
[ ] Test the social preview image on the final domain.
10. DEVELOPMENT AND PUBLISHING
------------------------------
From the project folder:
npm install
npm run build
npm run release
Use npm run build before publishing. Only publish after reviewing the live
CMS data, contact address, privacy wording, and notification destination.