TuneShack Blueprint
Complete Application Architecture & Sitemap
Last Updated: March 2026 — v3.0
1. PUBLIC PAGES
Home — Landing page with featured artists, playlists, spotlights & hero banner
Artists — Directory of all artists with search, filter & influencer badges
Playlists — Curated playlists with media player integration
Projects — Showcase of completed releases & projects
Events — Community events calendar, RSVP & map view
Radio — Live / streaming radio station
Impact — Community impact metrics & live reporting
Blog — Articles & news posts
About — About TuneShack & PWA Toronto
Contact — Contact form, support & donation
News — Announcements & community updates
Spotlight — Artist spotlight promotions
Community Gallery — User-submitted photo gallery
Artist Gallery — Artist image gallery
FMG Casting — Casting calls & FMG roster
Tutorial / How It Works — Onboarding guide for artists & members
Apply to be an Artist — Artist application form
Digital Arts — Digital art catalog
2. BOOKING & STUDIO
Book Studio — Studio space booking with room selection, pricing & availability
Book Artist — Artist booking requests for events & performances
Collaborative Booking — Multi-party booking with cost splitting between collaborators
Jam Sessions — Community jam sessions & open mics
Space Tours — Virtual 3D studio space tours (admin managed)
3. SHOP & COMMERCE
Membership — Community ($10/mo) / Artist ($25/mo) / Pro ($50/mo) plans
Gear Checkout — Equipment rental with availability, deposits & checkout tracking
Event Tickets — Event ticketing with tiers, Stripe checkout & confirmation codes
Ticket Check-In — QR/manual check-in scanner for event staff (admin)
Merch — Merchandise store with Stripe checkout
Beat Store — Digital beat & music sales
Spotlight Packages — Basic ($50/mo), Featured ($100/mo), Premium ($150/mo) promotion tiers
4. ARTIST FEATURES
Artist Profile — Public page with bio, projects, donations, booking & social links
Artist Portal — Artist profile editor, spotlight purchase & stats
Studio Portal — Booking history, portfolio builder & analytics dashboard (2 tabs)
Analytics Tab (in Studio Portal) — Earnings, bookings chart, room usage pie, booking heatmap, earnings history
Artist Newsletter — Subscriber management & email broadcasts
Artist Portfolio — Project gallery linked to studio sessions, publish/draft control
AI Playlist & Social Suggestions — LLM-generated playlist fits & social media prompts per project
Music Mentor — AI career mentor chat agent (Pro / Admin only)
5. GRANT WRITING SUITE (PRO / ADMIN) + RESEARCH PORTALS
Grant Writing Hub — Central hub for all grant tools (tabbed interface)
AI Assistant — Conversational AI sessions to draft & refine grant applications
AI Draft Generator — One-click section drafts: artist statement, impact narrative, full application
Grant Dashboard — Full CRUD, status tracking (drafting → submitted → approved/rejected)
Grant Budget Planner — Line-item budget builder with pie charts & coverage percentages
Grant Deadline Calendar — FACTOR, OAC, Canada Council, TAC deadlines with urgency alerts
Grant Matcher — AI eligibility scoring against major Canadian funders
Grant Scorer — AI-scored draft analysis with improvement suggestions per funder criteria
Grant Peer Review — Colleague review scoring (clarity, impact, feasibility)
Grant Template Library — Copy/paste templates for FACTOR, OAC, Canada Council, TAC
Grant Portfolio Links — Associate projects & artists with applications
Grant Version Tracker — Clone & track iterations of the same application
Grant Workflow Automation — Kanban-style pipeline with status transitions & metrics
Grant Impact Report — AI-generated narrative report using live platform metrics
Grant Won Archive — Archive & showcase of successful funded applications
Funder Criteria Manager — AI-scraped funder criteria database (admin)
Grant PDF Generator — Export complete application to PDF
Grant Report — Printable impact report page
Federal Grants Aggregator (NEW) — 43+ curated federal Canadian grants: CIHR, SSHRC, Canada Council, PHAC, Health Canada, ESDC, Justice Canada + FACTOR — searchable, with AI strategy tips & Apply with AI
Post-Award Compliance Tracker (NEW) — 14-task checklist per approved grant, spenddown tracker with visual progress bar, overdue alerts & reporting notes
Grant Portal — Standalone public grant intelligence & writing portal (no login required for most tools)
Prison Health Research Hub — Specialized research funding portal for PHRC with project manager, funder CRM, peer review, budget forecasting & AI proposal generator
6. ADMIN DASHBOARD (ADMIN ONLY)
Admin Dashboard — Central admin hub (multi-tab)
Financial: Payouts (with auto email confirmation), payout history, revenue dashboard
Content: Artists, Projects, Playlists, Blog, Applications
Community: Events, Jam sessions, Sponsorships, Spotlight packages, Gallery moderation
Shop & Gear: Gear items, Merch (with low-stock alerts), Beat store, Tickets, Memberships
Bookings: Studio bookings calendar, enhanced bookings, Collaborative bookings approval
Communications: Newsletter manager, bulk invite, email broadcasts
Analytics: Impact metrics, Grant reporter, Revenue analytics, AI suggestions
Ticket Check-In: QR/manual check-in scanner page
System: Page status control (enable/disable any page), space tours, testing tools
Admin Testing — Feature & integration testing panel
7. AI AGENTS (WHATSAPP + IN-APP)
TuneShack Concierge — General assistant (floating WhatsApp button on all pages)
Music Mentor — Career strategy & music industry guidance (Pro/Admin only)
Grant Writing Assistant — Specialized grant drafting & review agent
Booking Concierge — Studio & artist booking assistant
Portfolio Builder — Guides artists through creating portfolio entries
Studio Booking Concierge — Room selection & booking flow assistant
Artist Assistant — Per-artist career support
Community Hub — Events, jams & community questions
Impact Reporter — Generates impact narrative from platform data
Admin Operations — Admin task automation agent
Collaboration Matchmaker — Matches artists for collaborations (WhatsApp enabled)
Merch Revenue Advisor — Merch strategy & sales insights
Event Promoter — Event promotion copy & strategy
8. DATA ENTITIES (DATABASE)
• Artist
• User (built-in)
• Project
• StudioBooking
• GearItem
• GearCheckout
• Event
• EventTicket
• TicketPurchase
• EventRSVP
• Playlist
• BlogPost
• Announcement
• Donation
• ArtistNewsletter
• ArtistSubscriber
• ArtistPortfolio
• ArtistPayout
• ArtistBookingRequest
• SpotlightPackage
• Membership
• MerchProduct
• MerchOrder
• DigitalProduct
• DigitalPurchase
• CommunityJamSession
• CollaborativeBooking
• Sponsor
• NewsletterSubscriber
• ImpactMetric
• ArtistApplication
• SpaceTour
• BookingNotification
• PageStatus
• Favorite
• GalleryUpload
• ProjectSuggestion
• GrantApplication
• GrantBudget
• GrantReview
• GrantFunderCriteria
• GrantOpportunity
• ResearcherProfile
• ResearchProject
• ProjectTeamMember
• FundedResearch
• ResearchOutcome
• FunderContact
• FunderInteraction
• FunderPriority
• CollabPost
• ReferralPartner
• CorporateSponsor
• MajorDonor
• FundraisingCampaign
• SponsorProposal
• RiderFundraiser
• RallyExpense
9. BACKEND FUNCTIONS
Payment / Checkout: studioBooking, squareDonation, stripeCheckout, merchCheckout, digitalCheckout, ticketCheckout, spotlightCheckout, membershipCheckout, tipJar
Communication: sendArtistNewsletter, sendTestEmail, sendBookingNotification, notifyNewProject, bookingReminder, autoEventNewsletter, sendInviteEmails
Analytics / Reporting: updateLiveMetrics, weeklyLabelReport
AI / Automation: artistDiscoveryAgent, fanEngagementAgent, releaseHypeAgent, revenueAlertAgent, analyzeProjectForPlaylistsAndSocial, autoScanProjectsAndGenerateSuggestions
Grant Suite: generateGrantApplicationPDF, grantEmailReminder, scrapeFunderCriteria, grantDeadlineNotifier, grantContextLoader
Content / System: fetchYouTubeMusicTracks, getDownload, healthCheck, newsletterSubscribe
10. PAYMENT SYSTEMS
Stripe: Event tickets, merch, beat store, digital downloads, spotlight packages, membership subscriptions
Square: Studio booking deposits, artist donations / tip jar
Confirmation codes generated at purchase for ticket check-in validation
11. EXTERNAL INTEGRATIONS
Stripe — Primary payment processing (checkout sessions, subscriptions)
Square — Studio booking & donation payments
Resend — Transactional emails, newsletters, booking confirmations
Base44 LLM (InvokeLLM) — Grant writing, artist spotlights, impact reports, matching
YouTube API — Music track fetching & playback
FMG API — FMG casting roster integration
12. KEY FEATURES
✓ Real-time media player with queue management
✓ Global search across all content pages
✓ Artist favoriting & saved collections
✓ Newsletter subscription & artist subscribers
✓ Page status management (enable/disable any feature)
✓ Impact metrics & live community reporting
✓ Virtual 3D space tours
✓ Influencer artist tier (Collins Ajok, The Eccentric1, etc.)
✓ Full grant writing suite with AI, PDF, versioning & peer review
✓ Federal Grants Aggregator — 43+ Canadian federal programs in database
✓ Post-Award Compliance Tracker — spenddown, checklists & reporting
✓ Prison Health Research Hub (PHRC) — full standalone research portal
✓ Friends for Life Bike Rally Fundraising Command Centre
✓ AI Grant Draft Generator (one-click section drafts)
✓ Collaborative studio bookings with cost splitting
✓ Artist analytics dashboard with booking heatmap
✓ Merch low-stock alerts in admin
✓ QR ticket check-in system for events
✓ Music Mentor AI (Pro/Admin members only)
✓ WhatsApp AI concierge on all pages
✓ Mobile-responsive design with bottom navigation
✓ Dark mode support (system preference)
✓ PWA — installable on iOS & Android
✓ Offline indicator & pull-to-refresh on mobile
13. MOBILE & PWA
✓ Progressive Web App (PWA) — installable
✓ Responsive, mobile-first design
✓ iOS & Android installable app
✓ Safe area insets for notch / dynamic island
✓ Bottom navigation bar on mobile
✓ 44px minimum touch targets on all interactive elements
✓ Pull-to-refresh & offline mode indicator
TuneShack — 163 Queen St E, Toronto. A PWA Toronto Initiative. Built with React, Tailwind CSS & Base44 backend services. Payment processing via Stripe (primary) and Square. Last updated March 2026 v2.0.