Full-Stack Web Application Case Study

Free Social Bingo

Free Entertainment Events Platform

FreeSocialBingo/free-social-bingo|TypeScript 95.5%|Private Repository

A full-stack event management platform built from scratch using AI, featuring a 22-page admin panel, 50+ tRPC API procedures, 10-table relational database, and 6 automated email/notification systems — all with comprehensive test coverage across 28 test files.

Free Social Bingo Website
50+
API Procedures
tRPC endpoints across 7 route groups
10
Database Tables
Fully relational schema with Drizzle ORM
22
Admin Pages
Complete admin panel with analytics
28
Test Files
Comprehensive Vitest test coverage
12
Backend Modules
Server files including automation
6
Automation Jobs
Scheduled emails, reminders, feedback
Technology

Full Technology Stack

Every technology used to build Free Social Bingo, from frontend to infrastructure.

Frontend

React 19

Latest React with concurrent features

Tailwind CSS 4

Utility-first CSS framework

Framer Motion

Animation library for React

shadcn/ui

Accessible component library

Wouter

Lightweight React router

Lucide Icons

Icon library

Backend

Node.js / Express 4

Server runtime and HTTP framework

tRPC 11

End-to-end typesafe API layer

Zod

Runtime schema validation

Superjson

Type-safe serialisation (Date, BigInt)

Database & Storage

TiDB (MySQL)

Distributed SQL database

Drizzle ORM

TypeScript-first ORM with migrations

AWS S3

Object storage for images and files

Auth & Infrastructure

Manus OAuth

OAuth 2.0 authentication

JWT Sessions

Secure session management

Vite

Build tool and dev server

Vitest

Unit testing framework

TypeScript

End-to-end type safety

Backend Architecture

Under the Hood

A deep dive into the server-side architecture, database design, admin panel, and automation systems.

server/routers.ts— 1,748 lines (59.6 KB)

Authentication

server/routers.ts

Full auth lifecycle with profile management, email preferences, and account deletion

auth.meauth.logoutauth.updateProfileauth.updateEmailPreferencesauth.deleteAccountauth.getStatistics

Public event listing with capacity tracking, admin CRUD with bulk operations

events.listevents.getByIdevents.listAllevents.createevents.updateevents.deleteevents.bulkDeleteevents.bulkArchive

Full booking lifecycle with QR codes, status tracking, and customer portal

bookings.createbookings.getByRefbookings.listForEventbookings.cancelbookings.updateStatusbookings.bulkDeletebookings.myBookings

Subscriber management with segmentation, email composition, and delivery analytics

newsletter.subscribenewsletter.unsubscribenewsletter.listSubscribersnewsletter.sendnewsletter.getAnalytics

Post-event feedback collection with automated email triggers

feedback.submitfeedback.listForEventfeedback.getStats

Photo upload to S3, event galleries, and user-submitted photos

gallery.uploadgallery.listForEventgallery.deletegallery.userPhotos

Customer review submission with admin moderation and bulk operations

reviews.submitreviews.listreviews.approvereviews.bulkDelete

Email System

server/email.ts

Transactional emails with HTML templates for confirmations, reminders, and automation

email.sendBookingConfirmationemail.sendReminderemail.sendWelcomeemail.sendFeedbackRequest

The Challenge

Free Social Bingo needed a complete platform to manage free entertainment events across the UK — not just a website, but a full business operations system:

  • A complete admin panel to manage events, bookings, and attendees at scale
  • Automated email systems for confirmations, reminders, and post-event feedback
  • QR code check-in system for live events with mobile support
  • Newsletter and email marketing with subscriber segmentation
  • Customer portal for users to manage their own bookings and preferences

What We Built

We delivered a production-grade platform with enterprise-level backend features:

  • 22-page admin panel with real-time dashboard, bulk operations, and analytics
  • 50+ API procedures in a type-safe tRPC layer with Zod validation
  • 6 automation systems — welcome emails, booking reminders, event reminders, feedback requests, waitlist notifications, and scheduled tasks
  • Drag-and-drop email builder with templates, scheduling, and delivery analytics
  • Mobile QR check-in with manual attendee lookup fallback for live events
Frontend

Public-Facing Features

18 public pages built with React 19, Tailwind CSS 4, and Framer Motion.

Live event countdown timer with dynamic updates
Event listing with search, filtering by location/month/type
User dashboard with booking management and calendar export
VIP membership system integration
Games room section for interactive content
Event gallery with responsive image grid and S3 storage
Community spirit section with crowd photography
Newsletter signup with source tracking
Favourites system with sorting and persistence
Post-event feedback forms with rating system
Customer review submission with photo upload
Mobile-responsive design throughout
Admin Panel & CMS

The Backend That Powers Everything

Behind the public-facing website sits a comprehensive admin dashboard and content management system built with React 19, tRPC, and Drizzle ORM. Every feature below is powered by type-safe API procedures with Zod validation, connected to a 10-table TiDB database.

Click any screenshot to view it full-size. Use arrow keys or click the arrows to navigate between images.

Admin Dashboard Overview

Admin Dashboard — Real-Time KPIs & Event Capacity

React 19 + tRPC useQuery hooks + TiDB aggregation queries

Quick Actions & Guided Tour

Quick Actions Panel with Interactive Onboarding Tour

Custom tour engine + React state machine + localStorage persistence

Events Manager with Navigation

Events Manager — Full CRUD with Publish/Archive Workflow

tRPC mutations + Zod validation + bulk operations + optimistic updates

Events List View

Event Cards with Status Badges & Capacity Tracking

Drizzle ORM joins + real-time booking count aggregation

Bookings Management

Bookings Manager — Search, Filter, Check-In & CSV Export

tRPC + server-side filtering + CSV generation + QR code integration

All Bookings with Date Filters

All Bookings — Date Range Filtering & Status Overview

Date-fns + Drizzle date queries + status enum tracking

Mobile Check-In App

Mobile Check-In App — QR Scanner & Manual Lookup

html5-qrcode library + responsive mobile-first design + tRPC mutations

QR Code Scanner Modal

Live QR Code Scanner with Camera Integration

Browser MediaDevices API + html5-qrcode + real-time validation

Event Feedback Analytics

Feedback Analytics — Ratings, Distribution & PDF Export

Aggregation queries + rating distribution charts + PDF report generation

Email Templates with Preview

Email Template Builder with Live HTML Preview

Drag-and-drop editor + HTML email rendering + template CRUD via tRPC

API Layer

1,748 lines of tRPC procedures in server/routers.ts handling authentication, events, bookings, newsletters, feedback, gallery, reviews, and email delivery.

tRPC 11ZodSuperjsonExpress 4

Database

518-line schema in drizzle/schema.ts defining users, events, bookings, waitlist, newsletter subscribers, feedback, photos, reviews, and email templates.

TiDB (MySQL)Drizzle ORMAWS S3

Automation

6 automation modules handle welcome emails, booking confirmations, event reminders, feedback requests, waitlist notifications, and scheduled task execution.

Cron SchedulerHTML EmailLLM APIS3 Storage

Want a backend like this for your business?

We build custom admin dashboards, booking systems, and CMS platforms — powered by AI, delivered in days.

Request a Demo
Development Speed

Built in 7 Days, Not 7 Months

AI-enhanced development — guided by our expert team — compressed what would traditionally take 4–6 months of agency work into just 7 days — without sacrificing quality, test coverage, or production readiness.

AI-Powered Development

7 Days

Day 1–2Database schema, authentication, core API layer
Day 3Event management, booking system, QR codes
Day 4Admin dashboard, analytics, bulk operations
Day 5Email system, templates, newsletter composer
Day 6Automation (reminders, feedback, waitlist)
Day 7Testing, polish, deployment, and launch

Traditional Agency Development

4–6 Months (Estimated)

Week 1–2Requirements gathering, wireframes, proposals
Week 3–4UI/UX design, client revisions
Week 5–8Frontend development
Week 9–12Backend API and database development
Week 13–16Admin panel, email system, integrations
Week 17–20Testing, QA, bug fixes, deployment
95%
Time Saved
7 days vs 4–6 months
80%+
Cost Reduction
vs traditional agency
50+
Features Delivered
API procedures shipped
28
Test Coverage
test files from day one
Gallery

Public Website Screenshots

Free Social Bingo Homepage Hero
Countdown timer creates urgency and drives ticket bookings
01

Vibrant Hero Section

Eye-catching neon pink and cyan design with crowd photography, live countdown timer to next event, 'Book Free Tickets' CTA, floating ticket card, and key stats.

Event Listing with Search and Filters
Smart filtering helps visitors find events in their area
02

Event Finder & Booking System

'What's On' section with search bar, advanced filtering by Location, Month, Event Type, and Sort options. Event cards display dates, '100% FREE' badges, and prominent 'Get Free Tickets' buttons.

What To Expect Feature Cards
Builds excitement and sets expectations for new visitors
03

What To Expect Section

Four feature cards highlighting the experience — Completely Free Entry, Live Entertainment, Classic Games With A Twist, and Unique Performances.

Community and Event Timeline
Transparency about the event format builds trust
04

Event Timeline & Community

Detailed event timeline from 5:30pm to 11:00pm, Food & Drinks information, 'How It Works' explanation of the free entry model, and Community Spirit section.

The AI Advantage

How AI Transformed This Project

7-Day Delivery

This entire platform — 22-page admin panel, 50+ API procedures, 10 database tables, and 6 automation systems — was built and launched in just 7 days using AI-enhanced development guided by our expert team.

Cost Efficient

The entire platform — frontend, backend, database, email system, and admin panel — was built at a fraction of the cost of traditional agency development.

Production Quality

28 test files ensure reliability. Type-safe tRPC with Zod validation catches errors before they reach production. Role-based access control protects admin features.

"The AI-enhanced development process was incredible. Our team and AI working together delivered a feature-rich platform with a complete admin panel, automated emails, and QR check-in — faster than we ever expected."
FSB

Free Social Bingo Team

Founders, Free Social Bingo

They Own Their Code

Free Social Bingo owns their entire platform — frontend, backend, admin panel, and database — in a private GitHub repository. They can extend features, hire any developer, or migrate hosting at any time. No lock-in, no gatekeepers.

FreeSocialBingo/free-social-bingoPrivate
client/React frontend, event pages, booking flow
server/API, admin panel, email automation, QR check-in
drizzle/Database schema, events, bookings, venues
package.json
README.md
Private GitHub repo
Full admin access
Update by prompt
No lock-in

Need a Full-Stack Web Application?

We build complete platforms with admin panels, automation, and production-grade backends. Get a free consultation to discuss your project.

Cookie Preferences

We use cookies to enhance your experience, analyze site traffic, and for marketing purposes. By clicking "Accept All", you consent to our use of cookies. Read our Privacy Policy and Terms of Service for more information.