SetTimes User Guide¶
For Event Organizers
This guide will help you manage your events, venues, and performers on the SetTimes platform. No technical expertise required!
Table of Contents¶
- Getting Started
- Creating Your First Event
- Managing Venues
- Managing Performers
- Publishing Your Event
- Understanding the Interface
- Band Profile Pages
- Public Event Timeline
- Tips for Success
- Troubleshooting
Getting Started¶
Logging In¶
- Go to your admin panel at
settimes.ca/admin - Enter your email and password
- Click "Sign In"
Tip: Bookmark this page on your phone for quick access during event setup!
Your Admin Dashboard¶
After logging in, you'll see three main tabs:
- 📅 Events - Create and manage your events
- 📍 Venues - Add and edit performance locations
- 🎸 Performers - Schedule bands with times and venues
The interface is mobile-optimized with:
- Large touch targets (44px minimum)
- Bottom navigation on mobile
- Responsive design for all screen sizes
- Keyboard shortcuts on desktop
Creating Your First Event¶
Step 1: Open the Event Wizard¶
- Click the "Create Event" button (orange button at the top)
- The step-by-step event wizard will open
Step 2: Enter Event Details¶
Fill in the required fields:
- Event Name: e.g., "Spring Music Festival 2025"
- Event Date: The date your event takes place
- URL Slug: Short name for the web address (e.g., "spring-2025" creates
/events/spring-2025) - Description (optional): Brief description shown on public pages
Important: The slug will be used in the public URL and band profile URLs. Keep it short, lowercase, and use hyphens.
Step 3: Add Venues¶
For each performance location:
- Enter venue name (e.g., "The Analog Cafe")
- Add address (optional but recommended)
- Add website and social media links (optional)
- Click "Add Venue"
- Repeat for all venues
- Click "Next" when done
Tip: You can add more venues later if plans change!
Step 4: Add Performances¶
For each band/performer:
- Enter band name
- Select venue from dropdown
- Set start time (when they go on stage)
- Set end time or duration in minutes
- Add website URL (optional)
- Add social media links (optional)
- Click "Add"
- Repeat for all performers
Conflict Detection: The system will highlight scheduling conflicts if two bands are booked at the same venue at overlapping times.
Tip: Add bands in chronological order to stay organized!
Step 5: Review and Publish¶
- Review all information in the summary
- Click "Create Event" (saves as draft)
- Review the draft in the Events tab
- When ready, publish it (see Publishing Your Event)
Note: Events start as drafts. Only publish when all information is finalized!
Managing Venues¶
Adding a New Venue¶
- Go to the 📍 Venues tab
- Click "Add Venue"
- Fill in the form:
- Name (required)
- Address (recommended)
- Website (optional)
- Instagram (optional - enter username without @)
- Facebook (optional - full URL or page name)
- Click "Save Venue"
Design System: Venues use the SetTimes design system with accessible forms, clear labels, and helpful validation messages.
Editing a Venue¶
- Find the venue in the list
- Click the "Edit" button (pencil icon)
- Make your changes
- Click "Update Venue"
Viewing Venue History¶
- Find the venue in the list
- Click "History" or "View Details"
- See all past performances at that venue
- View statistics (total events, total performers)
Note: You cannot delete a venue that has active performances assigned to it.
Deleting a Venue¶
- Ensure no bands are currently assigned to the venue
- Click the "Delete" button (trash icon)
- Confirm deletion in the dialog
Warning: Deletions are permanent and cannot be undone!
Managing Performers¶
Adding a New Performer¶
- Go to the 🎸 Performers tab
- Select your event from the context banner (optional)
- Click "Add Performer"
- Fill in the form:
- Band Name (required)
- Event (select from dropdown or leave blank)
- Venue (select from dropdown or assign later)
- Start Time (required if event/venue set)
- End Time OR Duration in minutes
- Website (optional)
- Instagram (optional - username without @)
- Facebook (optional)
- Description (optional - shown on band profile page)
- Click "Save Performer"
Editing a Performance¶
- Find the performance in the list
- Click "Edit" button (pencil icon)
- Make your changes
- Click "Update Performer"
Tooltips: Hover over field labels to see helpful tips and requirements.
Deleting a Performance¶
- Find the performance in the list
- Click "Delete" button (trash icon)
- Confirm deletion in the confirmation dialog
Confirm Dialog: SetTimes uses a confirmation dialog to prevent accidental deletions of important data.
Warning: Deleting a performance cannot be undone!
Mobile Swipe Gestures¶
On mobile devices:
- Swipe left on a band to reveal the delete button
- Swipe right to hide the delete button
Publishing Your Event¶
Making Your Event Public¶
- Go to the 📅 Events tab
- Find your draft event (marked with a "Draft" badge)
- Click "Edit"
- Check the "Published" checkbox
- Click "Save Changes"
Important: Only publish when ALL information is correct! Once published, attendees can see it on the public timeline.
Event Status Badges¶
Events display color-coded status badges:
- Draft (gray) - Not visible to public
- Published (green) - Live and visible
- Archived (orange) - Past event, read-only
Unpublishing¶
Need to make changes to a published event?
- Go to the 📅 Events tab
- Find your event
- Click "Edit"
- Uncheck "Published"
- Make your changes
- Re-publish when ready
Tip: Unpublishing removes the event from the public timeline immediately.
Understanding the Interface¶
Context Banner¶
When you select an event, a context banner appears at the top showing:
- Event name and date
- Number of performers and venues
- Quick action buttons (View Event, Clear Selection)
Benefit: Helps you stay focused on one event at a time and avoid mistakes.
Breadcrumbs¶
Navigation breadcrumbs show your current location:
All Events > Spring Festival 2025 > Performers
Click any breadcrumb to navigate back.
Design System Components¶
SetTimes uses a consistent design system throughout:
Buttons:
- Primary (orange) - Main actions like "Save" or "Create"
- Secondary (outlined) - Less prominent actions like "Cancel"
- Danger (red) - Destructive actions like "Delete"
- Ghost (transparent) - Tertiary actions
Alerts:
- Success (green) - Operation completed
- Error (red) - Something went wrong
- Warning (yellow) - Important notice
- Info (blue) - Helpful information
Loading States:
- Animated spinners show when data is loading
- Prevents accidental double-clicks
- Provides visual feedback
Tooltips:
- Hover over labels with (?) icon to see helpful tips
- Works on both hover (desktop) and focus (keyboard)
Accessibility Features¶
SetTimes is WCAG 2.1 AA compliant:
- Keyboard Navigation - Use Tab, Enter, Escape to navigate
- Screen Reader Support - All content properly labeled
- Focus Indicators - Clear outlines show where you are
- Skip Navigation - Press Tab on page load to skip to main content
- Reduced Motion - Respects user motion preferences
Band Profile Pages¶
What are Band Profiles?¶
Every band/performer automatically gets a public profile page at:
settimes.ca/bands/[event-slug]/[band-name]
Example: settimes.ca/bands/spring-2025/the-sunset-trio
Profile Features¶
Automatically Generated Content:
- Band name and description
- Event association
- Venue and performance time
- Social media links (if provided)
- Performance history (if multiple events)
- SEO-optimized metadata
SEO Optimization:
- Open Graph tags for social sharing
- Twitter Cards for previews
- Proper page titles and descriptions
- Canonical URLs
Sharing:
- Share links automatically include rich previews
- Facebook, Twitter, LinkedIn show band info
- QR codes can be generated for posters
Editing Band Profile Content¶
- Go to 🎸 Performers tab
- Find the band and click "Edit"
- Update the Description field (supports markdown)
- Upload a photo — drag-and-drop or click to browse (JPG/PNG/WebP, up to 5 MB). It is stored in Cloudflare R2 and appears on the public profile, the schedule-card thumbnail, and link previews.
- (Recommended) Fill in Photo alt text — a short description of the image for screen readers and for when the image fails to load. Defaults to the band name if left blank.
- Add or update social media links
- Click "Save"
Tip: Write compelling descriptions that fans will want to read and share!
Public-Facing Features¶
Beyond the schedule itself, fans get a few experience features worth knowing about:
- Themes — four selectable colour themes (two dark, two light) via the swatch picker in the public header; the choice persists per browser. The admin panel always stays on the dark theme regardless of the visitor's pick.
- My Route — a fan's personal lineup (formerly "My Schedule"). Fans tap performers to add them; the route is saved in their browser and can be shared as a
/s/<code>link with rich social previews. - Artist Directory — a public, searchable index of every artist who has performed at a SetTimes event, at
/artists(linked from the homepage). Each card links to that artist's profile.
Public Event Timeline¶
What is the Timeline?¶
The public-facing event schedule at settimes.ca shows:
- All published events
- Real-time performance schedules
- Venue locations
- Band profile links
Timeline Features (Sprint 2.1)¶
Filtering:
- Filter by venue (click venue name)
- Filter by month (click month selector)
- Clear filters to see all events
Real-Time Updates:
- Changes appear within 1-2 minutes
- No need to refresh manually
- Cache automatically managed
Mobile-Optimized:
- Responsive cards for each performance
- Swipeable on mobile
- Bottom sheet navigation
Accessibility:
- Keyboard-navigable
- Screen reader friendly
- High contrast ratios
Testing Your Event¶
Before announcing:
- Publish the event
- Open
settimes.cain a private/incognito window - Verify all bands appear
- Check times and venues are correct
- Test band profile links
- Test on mobile device
- Share with a friend for feedback
Tips for Success¶
Before the Event¶
- [ ] Create event at least 2 weeks in advance
- [ ] Add all venues first, then performers
- [ ] Add accurate times with 15-30 minute buffers between sets
- [ ] Review for scheduling conflicts (highlighted in red)
- [ ] Write compelling band descriptions
- [ ] Add all social media links
- [ ] Test the public timeline on multiple devices
- [ ] Publish event
During Setup¶
- [ ] Keep venue names consistent (avoid "The Analog" and "Analog Cafe")
- [ ] Use clear, readable time formats
- [ ] Add realistic set lengths (account for setup/teardown)
- [ ] Double-check AM/PM times
- [ ] Get feedback from someone else before publishing
- [ ] Have a backup plan for last-minute changes
Best Practices¶
Save Often:
- Don't rely on auto-save
- Click "Save" after every major change
Double-Check Times:
- Incorrect times cause attendee confusion
- Allow buffer time between bands
Keep It Simple:
- Use official band names (as they brand themselves)
- Don't overcomplicate venue names
- Write clear, concise descriptions
Test Before Publishing:
- Always preview the public schedule
- Check on both mobile and desktop
- Verify all links work
Backup Important Info:
- Screenshot your final schedule
- Export event data if available
- Keep venue contact info handy
Troubleshooting¶
"I can't add a performance - the venue dropdown is empty"¶
Solution: Add venues first! Go to the Venues tab and create your venues before adding performances.
"I see a conflict warning but the times look right"¶
Solution: Check the full time range. A band ending at 9:00pm conflicts with another starting at 9:00pm at the same venue. Leave at least 15-30 minutes between acts for setup/teardown.
"My changes aren't showing on the public timeline"¶
Solution:
- Make sure the event is Published (not Draft)
- Wait 1-2 minutes for the cache to update
- Refresh the page (Ctrl+R or Cmd+R)
- Try a private/incognito window
- Check that the event date hasn't passed
"I accidentally deleted a performance"¶
Solution: Unfortunately, deletions are permanent. You'll need to re-add the performance manually. Always confirm carefully in the deletion dialog!
Prevention: SetTimes shows a confirmation dialog to prevent accidents.
"The admin panel isn't loading on my phone"¶
Solution:
- Pull down to refresh the page
- Check your internet connection
- Try a different browser (Chrome, Safari, Firefox)
- Clear your browser cache
- Make sure you're at
settimes.ca/admin - Contact support if the issue persists
"I can't delete a venue"¶
Solution: You cannot delete a venue that has performances assigned to it. You need to:
- Go to Performers tab
- Find all performances at that venue
- Either delete them or reassign them to a different venue
- Then you can delete the venue
Protection: This prevents data integrity issues.
"The event wizard won't let me continue"¶
Solution: Check for:
- Required fields marked with asterisks (*)
- Red error messages under fields
- Invalid date formats
- Duplicate event slugs
Validation: SetTimes validates all data before saving to prevent errors.
"Band profile links return 404 errors"¶
Solution:
- Ensure the event is published
- Check the event slug is correct (no spaces or special characters)
- Verify the band is assigned to that event
- Wait 1-2 minutes for cache updates
- Check the full URL format:
settimes.ca/bands/[event-slug]/[band-name-slug]
"I need to change the event slug after publishing"¶
Solution: Changing slugs breaks existing links. If you must:
- Create a new event with the correct slug
- Duplicate all venues and performers
- Unpublish and archive the old event
- Update any external links or social media posts
Best Practice: Choose slugs carefully before publishing!
Mobile Optimization Tips¶
Touch-Friendly Interface¶
All buttons and interactive elements are optimized for mobile:
- Minimum 44x44px touch targets (WCAG AAA)
- Large, easy-to-tap buttons
- Generous spacing between elements
- No tiny checkboxes or links
Bottom Navigation (Mobile)¶
On mobile devices, use the bottom navigation bar:
- 📅 Events - Manage events
- 📍 Venues - Add/edit venues
- 🎸 Performers - Schedule performances
Form Tips¶
Auto-Optimized Keyboards:
- Email fields show email keyboard
- Number fields show number pad
- URL fields show URL keyboard (with .com shortcut)
- Time fields show time picker
Auto-Complete:
- Venue names auto-suggest from existing venues
- Band names auto-suggest if they've performed before
Keyboard Shortcuts (Desktop)¶
Global:
Tab- Navigate through form fields and buttonsShift + Tab- Navigate backwardsEnter- Submit forms or activate buttonsEscape- Close modal dialogs and dropdownsCtrl/Cmd + S- Save current form (when available)
Navigation:
Alt + E- Go to Events tabAlt + V- Go to Venues tabAlt + P- Go to Performers tab
Accessibility:
Tabon page load - Reveals "Skip to main content" link- Focus indicators always visible
Getting Help¶
In-App Help¶
- Tooltips: Hover over (?) icons for contextual help
- Validation Messages: Red error messages explain what's wrong
- Empty States: Helpful prompts when tabs are empty
- Context Banner: Shows current event context
Documentation¶
- User Guide (this document) - Comprehensive how-to guide
- Admin Handbook - For system administrators
- Quick Start Guide - 10-minute setup tutorial
- Troubleshooting Guide - Common issues and solutions
Contact Support¶
- GitHub Issues: github.com/BreakableHoodie/settimesdotca/issues
- Include:
- Your event name
- What you're trying to do
- Screenshots (help us help you faster!)
- Browser and device info
Quick Reference Card¶
Login: settimes.ca/admin
Add Event: Events tab → Create Event → Follow wizard
Add Venue: Venues tab → Add Venue → Fill form → Save
Add Band: Performers tab → Add Performer → Fill form → Save
Publish: Events tab → Edit event → Check "Published" → Save
Emergency Stop: Events tab → Edit event → Uncheck "Published" → Save
Security & Privacy¶
Your Data is Protected¶
SetTimes uses industry-standard security:
- HTTPS/TLS encryption for all data transmission
- HTTPOnly cookies prevent XSS attacks
- CSRF protection on all state-changing requests
- Role-based access control (only editors/admins can modify data)
- Audit logging tracks all important actions
- Regular security audits — see
docs/code-review/for the review history
Best Practices¶
Passwords:
- Use a strong, unique password (min. 8 characters)
- Include uppercase, lowercase, and numbers
- Never share your credentials
- Change passwords quarterly
Account Security:
- Log out when using shared devices
- Don't save passwords on public computers
- Enable 2FA if available
- Report suspicious activity immediately
Frequently Asked Questions¶
Q: Can multiple people edit the same event? A: Yes! Multiple editors can work simultaneously. However, the last save wins, so coordinate with your team to avoid conflicts.
Q: Can I import data from a spreadsheet? A: Not currently, but this feature is planned. For now, use copy-paste to speed up data entry.
Q: How many events/venues/bands can I create? A: No hard limits! The system is designed to scale. Performance is optimized for hundreds of events.
Q: Can I customize the public timeline appearance? A: The timeline uses the SetTimes design system. Custom branding may be available for enterprise plans.
Q: Can attendees buy tickets through SetTimes? A: Not currently. Add ticket links to event descriptions or band profiles.
Q: Is there an API for integrations? A: Not yet, but an API is on the roadmap. See API_DOCUMENTATION.md for planned features.
Q: Can I export my event data? A: Database export tools are available to administrators. Contact support for assistance.
Questions? Refer to the other guides:
- Admin Handbook - For system administrators
- Quick Start Guide - 10-minute setup tutorial
- API Documentation - For developers
- Troubleshooting Guide - Common issues
Version: 2.0 Last Updated: 2026-07-04 For: SetTimes Platform (settimes.ca)
Need More Help? We're here to make your event a success! Contact us anytime through GitHub issues or your administrator.