← all work

$ open ./work/campus-systems

Campus systems

Four internal web apps for the staff of the GGWO campus in Baltimore: digital signage for the TVs around the buildings, emergency codes and security reports, messages on desk phones, and a control board for a live call-in show.

apps

4

media system

~18k

lines of code

stack

React · PrimeReact
Express · MySQL · WebSockets

years

2024 – 2025
plus a UniFi network of 250+ devices

Media System: a grid of signage slides with owner tags, the playlists they are in, and their schedules
The Media System's image library. Every card shows who owns it, where it is used and when it is scheduled.

// the apps

demo data, not real people or content
01

Media System

Content, playlists and schedules for every TV on campus.

02

Security System

One-tap emergency codes and daily security reports.

03

Desk Phones

Messages pushed to the screens of the office desk phones.

04

Grace Hour

Callers, notes and a shared clock for a live show.

// 01 media system

digital signage

Media Systemthe biggest of the four

The campus has TVs around its buildings, and many teams want something on them: the school, the youth group, the café, the office. The Media System lets each team upload its own images, videos and web pages, put them in playlists, schedule them, and send them to any screen from the browser.

Every TV runs a small player device that opens a display page full screen. When someone edits a slide, every screen showing it updates right away over WebSockets, with no one walking around with a USB stick or a remote.

building what a screen shows

Playlist editor: the media library on the left and the Lobby rotation playlist on the right, with items that can be dragged into order
The playlist editor. Drag images, videos and embeds from the library on the left into the playlist on the right, then drag them into order.
Display cards, each previewing its slides with schedule bars and the playlist name
Displays. Each card plays a preview of what that screen is showing, with its schedule on top.
List view of displays showing every slide of each display in a row
The same displays as a list, with every slide in order.
Display editor with the media library on the left and the Main lobby display on the right, holding two playlists
A display can hold whole playlists and single items. The main lobby plays two playlists back to back.
Edit Images dialog with Schedule, Repeat and Permissions sections
Any item can have a date range, a weekly repeat with hours, and its own sharing permissions.

on the TVs

TV showing a web page embed with today's schedule on campus
A web page embed on the office hallway TV.
TV at the school entrance showing exam week library hours
The school entrance TV, cycling through the school hallway playlist.
TV taken over by a red full-screen LOCKDOWN alert
An emergency message takes over every screen that has alerts turned on, and the screens go back to normal when it is cleared.
Devices table listing TVs with IP address, device ID, assigned display and online status
Every player device registers itself. Admins see which ones are online, point them at another display, or reboot them remotely.

the library

Video library with six promo videos
Videos are compressed on the server with ffmpeg after upload.
Embed library with a news ticker, clock and weather, a countdown, a calendar and today's schedule
Embeds are live web pages: a clock, a countdown, a calendar, a news ticker.
Image info dialog with values, references, permissions and log sections
Each item's details: its file, where it is used, who can see or edit it, and its history.
Image library with three cards selected and the bulk action buttons enabled
Select several items to link, edit or delete them together.
Log table of who added, edited, linked or deleted which item and when
A log of every change: who did what, to which item, and when.
Media System on a phone: the image library in one column with a bottom tab bar
It works on a phone too.
Displays on a phone with schedule bars and slide previews
Displays on a phone.

Content

  • Images, videos and web page embeds
  • Small previews made with sharp, videos compressed with ffmpeg
  • Search, sort, filters and @tag search by owner

Scheduling

  • Start and end dates, weekdays and hours
  • A playlist's schedule can override its items'
  • Per-item duration and transitions: fade, slide, zoom, flip, cut

Screens

  • Player devices register, report online and can be rebooted
  • Overlays on top of the slides, like a news ticker
  • Switches to the YouTube livestream when a service goes live

Teams and permissions

Each person has a colored tag, and 22 permission flags decide what they can add, see, edit and delete. Items can also be shared with other people one by one, or transferred to a new owner.

Live everywhere

Every change is sent as a typed WebSocket event. Open dashboards and the TVs reload only what changed, and edited images get a new cache key so no screen keeps an old version.

// 02 security system

emergency codes and reports

Security Systembuilt to work from a phone

Each code is one colored card: Lockdown, Evacuate, Medical, All Clear. Tapping one and confirming sends a text message to the code's contact list and calls the code's phone number, such as the paging line. If the code asks for it, the desk phones are taken out of do-not-disturb first so the call gets through. The screen shows each step as it finishes, and every send is logged.

Officers also write their daily activity report here: shift details, patrol entries with times and photos, and a signature drawn on the screen. The server turns it into a PDF that can be previewed, downloaded or printed.

Security System codes: colored cards for Lockdown, Evacuate, Shelter, Severe Weather, Medical, Lost Child, Drill and All Clear
The codes, each with its own colors, message, contact list and phone number.
Sending a code: the text message is done and the phone call is in progress
Sending a code: the text message has gone out and the call is still connecting.
A daily activity report PDF with general information, patrol entries and the officer's signature
A daily activity report as a PDF, rendered with pdfkit. Long reports break onto new pages, each with the header and signature.
Security codes on a phone in two columns with a bottom tab bar
The same codes on a phone.
Confirmation dialog: Send code Lockdown?
One confirmation before anything is sent.
Progress of the text message and the phone call shown over the codes
Live progress of each step.

// 03 desk phones

messages on the office phones

Desk Phonesa message on every desk in seconds

The offices use Yealink desk phones, and those phones can show a full-screen text message pushed to them over the network. This app lists every phone with its extension, model, IP address and firmware, and checks every few seconds which ones are online.

Staff pick the phones, write the message as Yealink XML in a code editor, and send it. Messages are saved as templates, and each template can remember its own group of phones, like "all classrooms" for a fire drill notice.

Desk Phones app: available and selected phones with online status at the top, the Fire drill XML template in a code editor, and the template list
Available phones on the left, the chosen ones on the right, and the fire drill template ready to send.

// 04 grace hour

a live call-in show

Grace Hourthe producer's board and the host's screen

Grace Hour is a live show where people call in with questions. The producer takes the calls and types each caller's line, name, location and question, plus notes for the host. The host has a big screen in the studio with the callers, the notes and the comments from the stream.

The clock and the countdown run on the server and go to every screen once a second, so the producer and the host always see the same time. The on-air button switches every screen at once.

Host screen with callers, notes, stream comments, the clock and the countdown
The host's screen. The comments panel shows the stream chat, here with placeholder messages.
Producer screen with the caller table, a rich text editor for notes, and the live button
The producer's screen: callers at the top, notes in a rich text editor, and the on-air button.

// how it works

architecture
4 web apps   react · primereact · react router · one path each (/media, /security, ...)
             │
             │  REST with JWT  +  WebSockets for live updates
             ▼
4 express servers · mysql
   ├─ media      sharp + ffmpeg for uploads, player devices over websockets,
   │              youtube live check, an endpoint for emergency messages
   ├─ security   pdfkit reports, clearstream text messages, a SIP dialer for
   │              the paging line, XML push to the desk phones
   ├─ phones     phone list, online checks, templates  ──▶  security server
   └─ grace hour callers, notes, the shared clock and on-air state
             │
             ▼
campus network   TVs with player devices · yealink desk phones · unifi, 250+ devices

// hard parts

what I'd talk about in an interview

Screens that change slides together

When several TVs show the same display, they should flip at the same moment. Instead of each TV counting on its own, a synced display works out the current slide from the clock: the time modulo the length of the whole loop. The TVs stay in step even after one of them restarts.

Scheduling at two levels

Every item has an optional date range and a weekly repeat, with the weekdays stored as a 7-bit mask and a start and end hour. A playlist can have its own schedule that overrides its items'. The player checks this before every slide, so a Friday-only slide disappears on Saturday without anyone touching it.

Live updates without reloads

Every add, edit, link and delete is broadcast as a typed WebSocket event. Dashboards and TVs refetch only the data that changed, and a cache counter in the image URLs makes sure an edited image replaces the old one everywhere.

Talking to hardware

The desk phones take XML pushed over HTTP, and their online status comes from a quick TCP check. The TV players connect over WebSockets with ping and pong, so the server knows when one drops off, and it can tell a player to reboot or open another display.

An emergency in two taps

Sending a code runs several steps in order: a text message to a contact list through Clearstream, the desk phones out of do-not-disturb, then a call through a local SIP dialer that hangs up on its own. Each step reports success or failure on the screen, so the person sending it knows what went out.

Reports that print well

The activity report PDF is laid out by hand with pdfkit. It measures each entry before drawing it, starts a new page when the next entry or photo won't fit, and repeats the header and the officer's signature on every page.

// stack

tools
frontend
react 18, create react app, primereact, primeflex, react router, formik, react hook form, dnd-kit, react-use-websocket, quill, react-pdf
backend
node, express, mysql, jsonwebtoken, bcrypt, ws
media
sharp, ffmpeg (fluent-ffmpeg), pdfkit
integrations
yealink xml push, clearstream sms, sip dialer, youtube livestream check
network
unifi

Internal tools built for GGWO staff. The source code is private. The screenshots come from the real app builds, running against invented demo data: no real staff, contacts, reports, phones or content.