Everything you need to know about Punk Nexus. From getting started to advanced features, we've got you covered. If you can't find what you're looking for, contact us.
Getting Started
Search Agents (AI Automation)
Finding & Filtering Events
RSVPs & Attendance
Social Features
Photos & Media
Reviews & Ratings
Sharing & Social Media
Band & Venue Accounts
Admin & Moderation
Advanced Features
Troubleshooting
FAQs
For Bands 🎸
For Venues 🏟️
For Labels 🏷️
Beta Testing Tools 🎮
Getting Started
3 articles
Creating Your Account
Sign up as a Member, Band, or Venue. Fill out your profile with a bio/quote, favorite bands (for fans), and travel distance preferences. Each account type has unique features tailored to your needs.
Setting Up Your Profile
Upload profile and header images (drag & drop supported), write a punk rock quote that defines you, select favorite bands from our database of 13+ verified bands, and set your travel distance (5-500 miles) to control event recommendations.
First Steps Checklist
1. Create account → 2. Upload profile pic → 3. Add punk quote → 4. Select favorite bands → 5. Create first search agent → 6. RSVP to upcoming event → 7. Follow some users → 8. Join the community!
Search Agents (AI Automation)
9 articles
What Are Search Agents?
Search agents are AI-powered assistants that monitor events 24/7 for you. They find shows matching your preferences (bands, location, price, genres) and notify you instantly. Think of them as your personal punk rock concierge.
Creating Your First Agent
Go to Profile → Search Agents → Create Agent. Configure: 1) Agent Name (e.g., "LA Hardcore Shows"), 2) Favorite Bands (select multiple), 3) Cities/States to monitor, 4) Subgenres (punk-rock, hardcore, pop-punk, etc.), 5) Price Range (min/max), 6) Travel Distance (5-500 miles), 7) Run Schedule (daily, weekly, monthly, or on-demand).
Run Now Feature ⚡
NEW! Don't wait for scheduled runs. Click the green "Run Now" (▶) button to instantly execute your agent. Get immediate results in a beautiful modal showing all matched events with images, details, and ticket links. Perfect for testing agent configurations or last-minute event hunts.
Agent Scheduling
Choose how often agents run: DAILY (set time like "09:00"), WEEKLY (choose day of week + time), MONTHLY (choose day of month + time), or ON_DEMAND (manual runs only). Daily agents are best for active fans, weekly for casual listeners.
Price Drop Alerts
Enable "Notify on Price Drop" when creating agents. Get instant alerts when ticket prices decrease for events matching your criteria. Never miss a deal on your favorite shows.
How Agents Work (v1.1 Intelligence Upgrade)
Our upgraded Master Discovery Agent v1.1 uses smart scheduling (57% more efficient), intelligent duplicate detection (40% better - catches "Bad Religion" vs "Bad Religion Live"), automatic event type classification (festivals, tours, DIY shows), and incremental updates. Searches 25+ cities daily across multiple ticket vendors (Ticketmaster, Eventbrite, Bandsintown, etc.). Your personal agents scan this continuously refreshed database - when matches are found (band + location + genre + price), you get in-app and optional email notifications.
Managing Multiple Agents
Create unlimited agents for different scenarios: 1) Local cheap shows (<$20), 2) Favorite bands anywhere (no distance limit), 3) Road-trip worthy headliners (100+ miles), 4) Festival alerts (specific cities). Edit, pause (Power button), delete (Trash icon), or run (Play button) agents anytime from your agents page.
Master Discovery Agent 🤖
Our system-level AI runs daily at 3:00 AM PST, searching 25+ major punk cities across 18 states. It discovers real events from Ticketmaster, Eventbrite, See Tickets, and other major vendors, then auto-classifies by subgenre, downloads authentic band images, and adds to database. Visible in Admin panel.
Agent Best Practices
Tips for optimal agent performance: 1) Be specific with bands (add 3-10, not 50+), 2) Use realistic travel distances, 3) Set price limits to filter out VIP packages, 4) Create multiple narrow agents vs one broad agent, 5) Test with "Run Now" before saving, 6) Review "Total Matches" metric to gauge effectiveness.
Finding & Filtering Events
7 articles
Using the Search Bar
Type band names, venue names, cities, or keywords like "festival" or "all ages". Search debounces after 1 second and automatically tracks your searches for analytics (helps us improve coverage). Filters appear below: State (multi-select), City, Subgenre, Price Range, Sort Order.
Calendar View
Switch from List to Calendar to see events visually by date. Each calendar day shows: Event thumbnails (24x24px images), Event titles (2 lines max), Event count badges for busy days, "+X more" indicator for additional events. Click any day to filter to that date. Month/year navigation at top.
Subgenre Filtering
Filter by 8 punk subgenres: punk-rock (classic sound), hardcore (fast/aggressive), pop-punk (melodic hooks), ska-punk (horn sections), street-punk (working class anthems), melodic-hardcore (emotional intensity), anarcho-punk (political edge), post-punk (experimental). Events auto-classified by AI.
Advanced Filters
Combine filters for precise results: State + City + Subgenre + Price Range + Date Range. Example: "California + Los Angeles + hardcore + $0-$25 + December 2025" shows affordable LA hardcore shows in December. Save combinations as search agents.
Sorting Options
Sort events by: Date (earliest first - default), Date (latest first), Name (A-Z), Name (Z-A), Price (low to high), Price (high to low). Sorting preserves filter selections.
Event Details Page
Click any event to see: Full description, Authentic band/promotional image, Venue details with map, Ticket link (external vendor), Lineup (multiple bands), Attendee list (Going/Interested/Went), Photo gallery (user-uploaded), Comments & replies, Similar events (AI-recommended), Share buttons + QR code.
Similar Events
AI recommends 6 similar events based on: Matching subgenre (+40 points), Same location (+20 points), Shared bands (+50 points), Similar price (+10 points), Close date (+15 points). Perfect for discovering more shows you'll love.
RSVPs & Attendance
6 articles
RSVP Options
Three RSVP statuses: GOING (confirmed attendance, triggers share prompt), INTERESTED (maybe/considering), WENT (past event, opens concert diary form). Your RSVP appears on event page attendee list and in your profile stats.
Concert Diary
After RSVPing "Went," fill out concert diary entry: Rating (1-5 stars), Written review, Setlist (songs played), Favorite moment, Photos from show, Friends who attended. All entries displayed on your profile with searchable history.
RSVP Stats & Insights
Your profile tracks: Total shows attended, Cities visited, Favorite bands (auto-calculated from RSVPs), Venues visited, Total distance traveled, Monthly/yearly trends. Gamification achievements unlock at milestones (10 shows, 5 cities, etc.).
Seeing Who's Going
Event pages show attendee lists with: User avatars, Names, RSVP status (Going/Interested/Went), Hometown/city, Follow button. Click profiles to view full profiles, see their concert history, and connect. Coordinate meetups via comments.
RSVP Sharing & QR Codes
When you RSVP "Going," a share prompt auto-appears with: Twitter share (auto-generated tweet), Facebook share, Reddit share, Email share, Downloadable QR code (PNG). QR codes link directly to event page - perfect for flyers/posters.
Friend Notifications
When you RSVP, your followers get notifications: "YourName is going to [Event]" with event details and link. Helps friends discover shows and coordinate attendance. Toggle notifications in Settings → Privacy.
Photos & Media
5 articles
Uploading Photos
Event pages have "Upload Photos" section. Drag & drop images or click to browse (JPEG/PNG, max 5MB each). Add captions for context (band, song, moment). Photos stored in cloud (S3) and optimized for web. Upload multiple at once.
Photo Privacy
Choose per-photo: PUBLIC (visible to all, appears in event gallery), PRIVATE (only you see it, appears in your profile). Change privacy anytime. Public photos can be featured on event pages and in search results.
Photo Gallery View
Click event photos to open lightbox: Full-screen view, Swipe between photos, Photographer attribution, Upload date, Caption display, Download button, Share to social media. Navigate with arrows or keyboard (←/→).
Profile Photo Gallery
Your profile shows all uploaded photos: Grid layout (responsive), Filter by event/date, Public vs private indicator, Edit captions, Change privacy, Delete photos. Shows total photo count and featured highlights.
Photo Guidelines
Keep Punk Nexus authentic: 1) Concert photos only (no unrelated content), 2) Respect band photo policies, 3) No offensive/hateful imagery, 4) Credit photographers when possible, 5) High quality preferred (but phone pics are fine!). Violations removed by admins.
Reviews & Ratings
4 articles
Rating Bands
Visit band pages to leave ratings (1-5 stars). Write detailed review: Sound quality, Stage presence, Crowd energy, Song selection, Overall vibe. Reviews appear on band profile and in search results. Edit/delete your reviews anytime.
Rating Venues
Rate venues for: Sound system, Layout/sightlines, Bar quality, Staff friendliness, Location/parking, Cleanliness. Help others find the best punk venues. Venue owners see reviews in their dashboard analytics.
Review Voting
Mark reviews as "Helpful" or "Not Helpful". Top-voted reviews appear first. Prevents spam and promotes quality feedback. Users with consistently helpful reviews earn "Top Reviewer" badge.
Review Moderation
Reviews flagged for: Offensive language (auto-filtered), Spam, Fake reviews, Off-topic content, Personal attacks. Admins review flags within 24 hours. Repeated violations = account warning/ban.
Band & Venue Accounts
4 articles
Band Accounts
Bands sign up for: Verified badge, Edit band profile (bio, images, social links), Claim events (auto-link to upcoming shows), Access analytics dashboard, Respond to reviews, Post announcements to followers, View fan heatmap (where fans live).
Venue Accounts
Venues get: Verified venue badge, Edit venue details (capacity, amenities, hours), Submit events directly, Manage bookings, Analytics dashboard (attendance trends, demographics), Respond to venue reviews, Post updates (closures, renovations, specials).
Analytics Dashboard
Band/venue analytics show: Total events (upcoming + past), Attendance trends (6-month graph), Geographic distribution (fan/attendee locations), Peak hours (when fans attend shows), Day of week breakdown, Monthly trends, Top cities, Key insights (AI-generated recommendations). Chart.js visualizations.
Verification Process
Request verification: 1) Sign up as Band/Venue, 2) Click "Request Verification" in dashboard, 3) Upload proof (social media screenshots, website, press kit, venue docs), 4) Admin reviews within 3-5 business days, 5) Verified badge appears on profile. Benefits: Trust, higher search ranking, analytics access.
Admin & Moderation
5 articles
Admin Dashboard
Admin panel (/admin/dashboard) shows: Real-time stats (users, events, RSVPs, comments), User management (ban, verify, delete), Event management (edit, feature, remove), Search agent monitoring (system + user agents), Auto-refresh toggle (30s interval). Access restricted to admin role.
User Moderation
Admin actions: BAN USER (permanent block, deletable), TEMPORARY BAN (set duration: hours/days/weeks), VERIFY USER (trust badge), DELETE USER (permanent, removes all data), VIEW ACTIVITY (see all user actions). Bans prevent login, hide content, and send email notification with reason.
Search Agent Management
Admins monitor all agents: View user agents (with owner/band/schedule details), Edit/delete any agent, See system agent (master discovery), Track agent runs (last run, next run, total matches), Filter by active/inactive/stale. Visible at /admin/dashboard → Search Agents tab.
Search Analytics 📊
NEW! /admin/search-analytics shows user search behavior: Total searches (7/30/90 day windows), Top cities searched (ranked with progress bars), Top states (demand heatmap), Popular subgenres, Band-specific searches, Daily timeline (line chart), AI insights (trending cities, expansion opportunities). Use to optimize master agent coverage.
Content Moderation
Flag system for: Comments (spam, offensive, off-topic), Photos (inappropriate, unrelated), Reviews (fake, attacks). Admins review flags, take action (warn, remove content, ban user), and track repeat offenders. Community reports encouraged.
Advanced Features
6 articles
Personalized Recommendations
AI recommends events based on: Favorite bands (highest weight), Location preferences (travel distance), Subgenre history, RSVP patterns, Friend activity, Price sensitivity. Algorithm scores each event 0-100, shows top matches on home page. Refreshes daily with new events.
Similar Events Feature
Event pages show 6 similar events calculated by: Subgenre matching (+40 points), Location proximity (+20 points), Shared bands (+50 points), Similar price (+10 points), Close date (+15 points). Helps fans discover related shows and build show schedules.
PWA (Progressive Web App)
Install Punk Nexus as app: Chrome/Edge: Visit site → Three-dot menu → "Install Punk Nexus", iOS Safari: Share button → "Add to Home Screen", Android: "Add to Home screen" banner. Benefits: App icon, faster load, offline caching (events/profiles), push notifications (coming soon).
Custom Themes
Settings → Theme to choose: Default (neon cyan + hot pink), Classic Punk (red + black), Cyberpunk (purple + neon green), Vapor Wave (pink + blue), Retro (orange + yellow), Dark (pure black + white). Custom CSS variables for each theme.
Master Agent Learning 🧠
System tracks all user searches (query, city, state, genre) and learns from behavior: Trending cities auto-added to discovery coverage, Popular subgenres prioritized, High-demand bands tracked more closely, Analytics dashboard shows insights, Automated config updates (coming soon). Makes discovery smarter over time.
API Access
Public API at /api/public/events: Query params (state, city, subgenre, minPrice, maxPrice, startDate, endDate), Pagination (limit, offset), Sorting, Rate limited (100 req/hour per IP), Returns JSON with event details, RSVPs, favorites. API docs at /api-docs with cURL/JS examples.
Troubleshooting
7 articles
Login Issues
Can't log in? 1) Check email/password spelling, 2) Clear browser cache/cookies, 3) Try incognito mode, 4) Reset password via "Forgot Password", 5) Disable browser extensions (ad blockers may interfere), 6) Try different browser. Still stuck? Email support with error details.
Search Agent Not Working
Agents not finding events? 1) Check agent is Active (green Power icon), 2) Verify bands are spelled correctly, 3) Expand location radius (try state-wide), 4) Broaden price range (no max limit), 5) Use "Run Now" to test immediately, 6) Check Total Matches - if 0 forever, criteria too narrow. Remember: agents only find new events added since last run.
Photo Upload Fails
Photos not uploading? 1) Check file size (max 5MB per photo), 2) Use JPEG or PNG format only, 3) Check internet connection, 4) Try one photo at a time, 5) Disable VPN temporarily, 6) Clear browser cache, 7) Try different browser. S3 storage occasionally has latency - wait 30 seconds and retry.
Missing Events
Don't see an event? 1) Master agent runs daily at 3 AM PST (new events added then), 2) Check if event is on supported ticket vendor (Ticketmaster, Eventbrite, etc.), 3) DIY shows may not be auto-discovered yet, 4) Use "Create Event" to add manually, 5) Submit venue/band for tracking via Help → Contact.
Notification Spam
Too many notifications? Settings → Notifications to control: Disable specific types (RSVPs, comments, etc.), Change email frequency (instant, daily digest, off), Mute specific users, Pause search agents temporarily, Reduce number of followed users. Find your balance.
Performance Issues
Site loading slowly? 1) Clear browser cache, 2) Check internet speed, 3) Disable browser extensions, 4) Close other tabs, 5) Try during off-peak hours (late night/early morning), 6) Use wired connection vs WiFi. We cache aggressively but initial loads take 2-4 seconds on slow connections.
Profile Not Saving
Changes not persisting? 1) Click green "Save Profile" button at top AND bottom of form, 2) Wait for success toast ("Profile updated!"), 3) Don't use browser back button (loses changes), 4) Check all required fields filled, 5) Image uploads require 5-10 seconds to process, 6) Refresh page to verify changes saved.
FAQs
10 articles
How often is data updated?
Master discovery agent runs daily at 3:00 AM PST, adding new events from 25+ cities. Real-time data: RSVPs, comments, photos, reviews (instant). Analytics: Updated hourly. Band/venue profiles: Edited in real-time by owners. Search agent data: Refreshed with each run (scheduled or manual).
Is Punk Nexus free?
YES! 100% free for fans right now. All features unlocked: unlimited search agents, photo uploads, RSVPs, social features. Future: Optional Premium ($5/mo) for ad-free, advanced analytics, early access. Band/Venue Pro subscriptions ($20-50/mo) for marketing tools. Core fan features ALWAYS free.
How are events discovered?
Master AI agent searches: Major ticket vendors (Ticketmaster, Eventbrite, See Tickets, etc.), Venue websites, Facebook events, Promoter pages. Uses keywords: "punk," "hardcore," band names, venue names, "all ages," etc. Classifies by subgenre using NLP. Downloads authentic promo images. Runs daily to catch new announcements.
Can I submit events?
YES! Click "Create Event" in top nav or /events/create. Fill out: Event name, Date/time, Venue, City/state, Lineup (bands), Description, Ticket link, Price. DIY shows, house shows, basement gigs all welcome. Admins review within 24 hours. Spam/fake events removed.
How do I add a band that's missing?
Currently: Profile → Favorite Bands → Type name → "Add [Band]" if not found → Submit for review. Admin approves within 3 days. Future: "Add Band" page for full profiles (bio, images, socials, discography). For now, email suggestions with: Band name, Genre, Website/social links.
What's the difference between system agent and user agents?
SYSTEM AGENT (Master Discovery): Runs daily at 3 AM PST, searches 25+ cities, adds events to database, visible to admins only, covers all 8 subgenres, downloads images. USER AGENTS: Created by you, search existing database, customizable filters (bands, location, price, etc.), run on your schedule or on-demand, send personal notifications.
How do I become verified?
BANDS: Sign up as band → Dashboard → "Request Verification" → Upload proof (Spotify, Bandcamp, Instagram, press kit) → Wait 3-5 days. VENUES: Sign up as venue → Dashboard → Submit verification (business license, venue website, social media) → Admin review. USERS: Active contributors (100+ RSVPs, 50+ reviews, trusted by community) get auto-verified.
Can I delete my account?
Yes. Settings → Account → "Delete Account" (red button at bottom). WARNING: Permanent! Removes: Profile, RSVPs, Comments, Photos, Search agents, Favorites, Followers/following. Concert diary deleted. Reviews anonymized. Action cannot be undone. Consider deactivating instead (hides profile but preserves data).
How does the master agent learn?
Tracks user searches (city, state, genre, bands) → Analyzes trends (which cities/bands searched most) → Admin sees insights in Search Analytics dashboard → Manual config updates to add trending cities → Future: Automated config updates based on demand. Example: If 50+ users search "Austin, TX," master agent adds Austin to discovery coverage.
What are the image sources?
Event images: 30+ pre-downloaded band-specific promotional photos (NOFX, Bad Religion, Dead Kennedys, etc.), Festival artwork (Riot Fest, Punk Rock Bowling), Venue graphics. User photos: Uploaded by fans at shows, stored in cloud (AWS S3), optimized for web. All images vetted for quality/appropriateness. Band images updated regularly.
For Bands 🎸
8 articles
Band Profile Setup
Sign up as a band account to access professional tools. Complete your profile with bio, genres (14 punk subgenres available), origin, social links (Facebook, Instagram, Twitter, Spotify, Bandcamp, YouTube), and music links. Your slug is auto-generated from your band name for SEO-friendly URLs.
Band Dashboard Overview
Access 7 comprehensive tabs: 1) Profile: Edit bio, genres, and basic info 2) Music: Add streaming platform links 3) Social & Web: Connect all social media 4) Tours: Plan multi-city tours with stops 5) Fans: View demographics and heatmaps 6) Email: Create targeted email campaigns 7) Analytics: Track performance metrics and insights
Tour Planning System
Create tours with name, description, start/end dates. Add tour stops for each city with venue, date, status (tentative/confirmed/cancelled), ticket links, notes, and expected/actual revenue. Track total shows and tour status (planning/active/completed/cancelled). Use fan heatmaps to identify optimal cities for your tour routing.
Fan Demographics & Heatmaps
View comprehensive fan analytics: Total fans count, Top 20 cities with fan concentration, Top states with fan distribution, Visual heatmap bars showing relative fan density. Get AI-generated tour insights like "Strongest fanbase in Los Angeles" or "Consider a West Coast regional tour". Data sources: favorite bands, event RSVPs, and fan club memberships.
Email Campaign Builder
Create targeted email campaigns with: Campaign name, subject line, rich text content, audience selection (All Fans, Fan Club Only, City-Specific, or Event RSVPs specific). Add multiple target cities for city-specific campaigns. Live preview your email before sending. Track metrics: recipient count, open rate, click rate (SMTP integration coming soon for actual sending).
Analytics Dashboard
Access detailed analytics: Summary stats (total events, average attendance, total RSVPs, total favorites), 6-month trend line chart, Geographic distribution (events by state), Peak performance hours bar chart, Day of week patterns, Key AI-generated insights for data-driven decisions. Owner-only access ensures privacy.
Booking Requests
Send booking requests to venues: Select target venue by slug, propose primary date and 2 alternate dates, include custom message. Track requests: View sent requests tab with status (pending/accepted/declined/counter_offer), see venue responses, manage multiple simultaneous requests. Venues can accept, decline, or send counter-offers.
Label Partnerships
Join record labels to expand your reach: Labels add you to their roster via roster API, relationship tracks start date, end date (optional), and role (signed, distributed, etc.), appear on label profile pages, link back to your band profile. Multiple label partnerships supported simultaneously.
For Venues 🏟️
7 articles
Venue Profile Setup
Create a venue account to manage your space: Add venue name, location (address, city, state, ZIP), capacity, contact info (phone, email, website), description highlighting your venue features, upload venue photos, connect social media accounts. Apply for verification badge for enhanced features.
Venue Dashboard
Manage your venue through 3 tabs: 1) Profile: Edit venue details, capacity, and description 2) Contact & Social: Update phone, email, website, and social media links 3) Events: View and manage your event calendar, submit new events, track attendance and RSVPs
Event Submission
Submit events directly through your dashboard: Add event name, date/time, description, ticket link, price, subgenre, event type (concert, festival, etc.), list performing bands (existing or create new). Verified venues get auto-approved events. Unverified venues need admin approval. Edit or delete your submitted events anytime.
Booking Request Management
Receive and manage booking requests from bands: View incoming requests with proposed dates and alternates, see band information and message, quick actions to accept or decline, send counter-offers with custom responses, track request history and status. Build relationships with touring bands.
Venue Analytics
Track your venue performance: Summary stats (total events hosted, average attendance, capacity utilization), 6-month trends showing booking patterns, Geographic distribution of bands (where they come from), Peak hours for best attendance, Popular genres at your venue, Day of week analysis for optimal scheduling. Owner-only access.
Verification Badge Benefits
Apply for venue verification to unlock: Auto-approved event submissions (no admin review needed), Priority listing in search results, Verified badge on your profile, Enhanced credibility with bands and fans, Access to premium features. Contact admin team with proof of ownership and business license for verification.
Building Your Audience
Grow your venue community: Encourage fans to favorite your venue, promote events through social media integration, use venue-specific QR codes for easy sharing, engage with event comments and feedback, build fan clubs for your venue (coming soon), track favorite counts and engagement metrics
For Labels 🏷️
7 articles
Creating Your Label
Navigate to /labels/new to create your record label: Add label name (required), write compelling bio, set founded year, select up to 14 punk genres, add logo URL, provide contact info (email, phone, website, address), connect social media (Facebook, Instagram, Twitter, Bandcamp, Spotify). Slug auto-generated from name for SEO-friendly URL.
Label Profile Features
Your public label profile displays: Label logo or gradient placeholder, name with glitch text effect, founded year and location, genre tags, band/release count stats, About/bio section, current roster (active bands with images), recent releases (up to 10 with cover art), contact information sidebar, social media links, office location. Server-side rendered for fast loading.
Roster Management
Add bands to your label roster via API: POST /api/labels/[slug]/roster with bandId (required), role (signed, distributed, etc.), startDate (defaults to today), endDate (optional, null for active). Each band-label relationship tracked separately. View active roster on profile page with band images and links. Historical relationships tracked with end dates.
Release Management
Create and track releases via API: POST /api/labels/[slug]/releases with title (required), type (album/EP/single/compilation), releaseDate (required), bandId (optional), coverArt URL, description, trackCount, streamingLinks JSON (Spotify, Apple Music, Bandcamp, YouTube). Display releases on label profile with band info, dates, and streaming links.
Label Discovery
Labels appear on /labels discovery page: Grid layout with logo, founded year, bio preview, genre tags (up to 3 shown), location, stats (band/release counts), featured bands preview (5 avatars). Search by name, genre, or location. Filter and sort options. Create Your Label CTA for easy onboarding. Responsive design (1/2/3 columns).
API Integration for Labels
Full API support for labels: GET /api/labels - list all with filtering, GET /api/labels/[slug] - profile details, POST /api/labels - create new (auth required), PUT /api/labels/[slug] - update (owner only), DELETE /api/labels/[slug] - remove (owner only), POST /api/labels/[slug]/roster - add band, POST /api/labels/[slug]/releases - create release. Rate limited to 100 requests/hour. Full docs at /developers.
Label Dashboard (Coming Soon)
Future label owner dashboard will include: Roster management UI (add/remove bands with dates), release creation form with cover art upload, analytics (band performance, release metrics), email campaigns to label followers, booking coordination for roster bands, label-specific fan clubs, financial tracking (sales, royalties). Currently managed via API.
Beta Testing Tools 🎮
10 articles
Quick Feedback Widget 🐛
Bottom-right floating button on every page for instant feedback. Click to report bugs or suggest features. Auto-captures: Current page URL, Browser/device info, Screen resolution, Viewport size. Choose between Bug Report (with severity levels) or Feature Suggestion (with priority). Includes category selection and description field. Submit in under 60 seconds without leaving your current page!
Beta Tester Dashboard 🏆
Your personal contribution hub at Profile → Beta Dashboard. See: Days in beta, Contribution score (calculated from all activities), Reputation points, Checklist progress (%), Bug reports (total & resolved), Suggestions (total & implemented), Platform engagement (RSVPs, diaries, agents, comments), Recent activity feed, Quick action buttons. Track your impact and compete on the leaderboard!
Leaderboard Rankings 🥇
Compete with other beta testers at Beta Dashboard → Leaderboard. Scoring: Resolved bugs (10 pts), Implemented suggestions (15 pts), Any bug report (2 pts), Any suggestion (3 pts), Concert diaries (5 pts), Comments (1 pt). Features: Top 3 podium display, Your rank highlighted, Stats for all top 50 testers (bugs fixed, ideas shipped, rep points), Detailed per-user metrics. Climb to #1!
Feature Voting System 👍👎
Vote on bugs and suggestions at Help → Known Issues & Suggestions. Click ↑ to upvote (priority increase) or ↓ to downvote. Click again to remove vote. Real-time vote counts displayed. Rate limited (100 votes/hour). Most-voted items get prioritized in development roadmap. Your vote matters - help us build what the community wants!
Changelog Viewer ⚡
Stay updated at Beta Dashboard → Changelog. Filter by: All Updates, New Features (electric blue), Bug Fixes (acid green), Improvements (neon purple), Coming Soon (cyber yellow). Each entry shows: Title, Description, Version tag, Release date, Type-specific icons and colors. Check weekly to see what shipped based on YOUR feedback! Admins can create changelog entries via POST /api/beta/changelog.
Testing Checklist ✅
11 guided tasks with point rewards (auto-tracked in Beta Dashboard): 1. Create account & complete profile (5 pts), 2. RSVP to event (5 pts), 3. Add concert diary (5 pts), 4. Create search agent (5 pts), 5. Favorite a band (3 pts), 6. Follow user (3 pts), 7. Comment on event (3 pts), 8. Upload photo (5 pts), 9. Test on mobile (5 pts), 10. Report bug (10 pts), 11. Submit suggestion (10 pts). Total: 59 points + reputation boost! API: GET /api/beta/testing-checklist.
Beta Announcements Banner 📢
Important updates displayed as sticky banner below header (when active). Type-specific styling: Info (blue), Success (green), Warning (yellow), Urgent (red). Features: Dismissible (saves to localStorage), Optional action links, Date-based display (startDate/endDate). Never miss critical platform updates! Admins create via POST /api/beta/announcements with title, message, type, and optional link.
Performance Feedback Tool 🚀
Report slow pages via feedback widget or dedicated API. Rate pages as: Fast, Average, or Slow. Add optional comment for context. Auto-captures page path. Admin dashboard (GET /api/beta/performance-feedback) shows aggregated stats per page with percentage breakdowns. Rate limited (100/hour). Helps us identify bottlenecks and prioritize optimization work!
Export My Data 📦
Download ALL your data (GDPR compliant) via GET /api/beta/export-data. Exports include: Profile info, All RSVPs, Concert diaries, Favorite bands, Search agents, Bucket list, Comments, Bug reports, Suggestions. Choose format: JSON (complete) or CSV (RSVPs only). Example: /api/beta/export-data?format=json. Removes sensitive data (passwords, tokens). Privacy-first design!
Feature Request Templates 📝
Pre-filled forms at Help → Known Issues & Suggestions → Submit Suggestion. 10 categories with helpful prompts: General, UI/UX Improvement, Mobile Enhancement, API Request, Events, Bands, Venues, Social Features, Search, Performance. Select a template to auto-fill description field with guided format. Speeds up suggestion submission and ensures you provide helpful details!
Still Need Help?
Can't find what you're looking for? We're here to help. Send us a message and we'll get back to you within 24 hours.
Social Features
6 articles
Following Users
Follow friends, favorite bands, and scene veterans. Click "Follow" on any profile. Your home feed shows: Their RSVPs, Concert diary entries, Photo uploads, Comments, New favorites. Unfollow anytime from profile or following list.
Followers & Following Lists
View your social graph: Followers (users following you), Following (users you follow), Mutual follows (highlighted). Lists show: User avatar, Name, Hometown, Follow/Unfollow button. Search/filter by name.
Notifications Bell 🔔
Top-right bell icon shows unread count. Click to see: NEW_FOLLOWER (someone followed you), NEW_EVENT (agent found match), COMMENT_REPLY (someone replied to your comment), COMMENT_LIKE (someone liked your comment), RSVP_FRIEND (friend going to event), BAND_EVENT (favorite band has show), PRICE_DROP (ticket price decreased). Real-time polling every 30s. Mark individual as read or "Mark All Read" button.
Activity Feed
Home page shows chronological feed: Friend RSVPs with event details, Concert diary entries with photos, Photo uploads with captions, New comments, Band announcements (verified bands only), System updates. Infinite scroll with lazy loading.
Comments & Discussions
Comment on event pages to: Ask questions ("All ages?"), Share excitement, Coordinate meetups, Discuss lineups. Features: Nested replies (up to 3 levels), Like button with count, Delete (your comments + admins), Timestamps (relative: "2 hours ago"), User avatars + links. Markdown formatting supported.
Privacy Controls
Profile settings control: RSVP visibility (Public/Friends/Private), Concert diary visibility, Photo gallery privacy, Activity feed inclusion, Email notification preferences, Show hometown on profile. Balance privacy with social connection.