diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..437b554
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,22 @@
+# ── Server ──────────────────────────────────────────────────────────────────
+PORT=3000
+
+# ── Email Notifications (SMTP) ───────────────────────────────────────────────
+# Leave blank to disable email alerts
+SMTP_HOST=smtp.example.com
+SMTP_PORT=587
+SMTP_SECURE=false
+SMTP_USER=you@example.com
+SMTP_PASS=yourpassword
+SMTP_FROM=alerts@example.com
+# Comma-separated list of recipient addresses
+NOTIFY_EMAIL=team@example.com
+
+# ── Slack Notifications ──────────────────────────────────────────────────────
+# Leave blank to disable Slack alerts
+# Create an Incoming Webhook at https://api.slack.com/messaging/webhooks
+SLACK_WEBHOOK_URL=
+
+# ── Generic Webhook ──────────────────────────────────────────────────────────
+# Leave blank to disable. POST payload: { event, timestamp, venues[] }
+WEBHOOK_URL=
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..9331324
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,4 @@
+node_modules/
+.env
+*.log
+db/
diff --git a/README.md b/README.md
index fe4178b..60211c0 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,94 @@
-# Web-tracker
\ No newline at end of file
+# Venue Carousel Tracker
+
+Monitors homepage carousel tiles across all O2 Academy venues and alerts the team when tiles are outdated or expiring soon.
+
+---
+
+## Requirements
+
+- [Node.js](https://nodejs.org) v18 or higher
+- npm (included with Node.js)
+
+---
+
+## Option 1 — Run Locally
+
+**1. Clone the repo**
+```bash
+git clone https://github.com/Lmhgn/Web-tracker.git
+cd Web-tracker
+```
+
+**2. Install dependencies**
+```bash
+npm install
+```
+
+**3. Start the server**
+```bash
+npm start
+```
+
+**4. Open your browser**
+```
+http://localhost:3000
+```
+
+On first run the server automatically creates the database and a default admin account:
+- **Username:** `admin`
+- **Password:** `admin`
+
+> Change your password after first login via the account menu.
+
+---
+
+## Option 2 — Deploy to Railway (free, no terminal needed)
+
+[Railway](https://railway.app) connects directly to your GitHub repo and hosts the server for you.
+
+**1.** Go to [railway.app](https://railway.app) and sign in with GitHub
+
+**2.** Click **New Project → Deploy from GitHub repo**
+
+**3.** Select **Lmhgn/Web-tracker** from the list
+
+**4.** Railway detects it as a Node.js app and deploys automatically
+
+**5.** Click the generated URL (e.g. `https://web-tracker-xxxx.up.railway.app`) to open the app
+
+Default login is the same: `admin` / `admin`
+
+> Railway gives 500 free hours/month — enough to run this continuously.
+
+---
+
+## Environment Variables (optional)
+
+Create a `.env` file in the project root to configure email alerts:
+
+```
+SMTP_HOST=smtp.example.com
+SMTP_PORT=587
+SMTP_USER=you@example.com
+SMTP_PASS=yourpassword
+ALERT_TO=team@example.com
+SESSION_SECRET=change-this-to-a-random-string
+```
+
+On Railway, set these under **Project → Variables** instead of a `.env` file.
+
+---
+
+## Status Indicators
+
+| Colour | Meaning |
+|---|---|
+| Red — Outdated | Event date has passed — tile needs replacing immediately |
+| Orange — Expiring Soon | Event is within the warning threshold (default 7 days) |
+| Green — OK | Event date is comfortably in the future |
+
+---
+
+## Venues Tracked
+
+All 20 O2 Academy venues plus Edinburgh Corn Exchange.
diff --git a/index.html b/index.html
new file mode 100644
index 0000000..128cb49
--- /dev/null
+++ b/index.html
@@ -0,0 +1,1813 @@
+
+
+
+ Venue Carousel Tracker
+
+
+
+
+
+
+
+
+
Venue Carousel Tracker
+
Sign in to continue
+
+
+
+
+ Username
+
+
+ Password
+
+
+ Sign In
+
+
+
+
+
+
+
+
+
+
+
— Outdated
+
— Expiring Soon
+
— Up to Date
+
— Total Events
+
— Venues
+
+
+
+
+
+
+
+
+
+ All
+ Outdated
+ Expiring Soon
+ Up to Date
+ Errors
+
+
+
+
+ Cards
+ Events
+ Catalogue
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Settings
+
+ Configure the warning threshold and auto-refresh schedule. Settings are saved in your browser.
+
+
+
+ Auto-refresh interval
+
+ Off
+ Every 15 minutes
+ Every 30 minutes
+ Every hour
+ Every 2 hours
+
+
+
+
+
Warning threshold — flag tiles expiring within
+
+
days (default: 7). Email/Slack notifications are configured via server .env
+
+
+
+ Cancel
+ Save
+
+
+
+
+
+
+
+
User Management
+
Manage who can access this tool.
+
+
+ Username Role Last Login Actions Loading…
+
+
+
Add User
+
+
+ User
+ Admin
+
+
+
+
Add User
+
+
+
+ Close
+
+
+
+
+
+
+
+
Change Password
+
+
+ Current Password
+
+
+ New Password
+
+
+ Confirm New Password
+
+
+ Cancel
+ Save
+
+
+
+
+
+
+
+
+
+
+
${esc(tile.artist)}
+
${esc(tile.dateStr)}
+
+ ${rel ? `
${rel} ` : ''}
+
No carousel tiles found.
';
+
+ const errorHTML = venue.error
+ ? `
+
` : '';
+
+ return `
+
+
+
+ ${errorHTML || tilesHTML}
+
+
+ `;
+}
+
+function renderVenues(venues) {
+ const grid = document.getElementById('venue-grid');
+ const arr = Object.values(venues);
+
+ const filtered = currentFilter === 'all'
+ ? arr
+ : arr.filter(v => v.overallStatus === currentFilter);
+
+ if (filtered.length === 0) {
+ grid.innerHTML = `No venues match this filter.
Venue Carousel Tracker
+
+
+ —
+ Outdated
+
+
+ —
+ Expiring Soon
+
+
+ —
+ Up to Date
+
+
+ —
+ Venues
+
+
+
+ Scanning all venues, this may take a minute…
+
+ All
+ Outdated
+ Expiring Soon
+ Up to Date
+ Errors
+
+
+
+
+
+
+
Loading venue data…
+
+
+
+
+
+
Notification Settings
+
+ Configure how the server sends alerts when carousel tiles become outdated.
+ Update your .env file and restart the server to apply.
+
+
+
+
Email (SMTP)
+
+SMTP_HOST=smtp.example.com
+
+
+
Slack
+
+SLACK_WEBHOOK_URL=https://hooks.slack.com/services/…
+
+ Generic Webhook
+
+WEBHOOK_URL=https://your-server.com/webhook
+
+
+
+
Close
+
+
+ ${v.name} ${t.artist}
+ ${t.dateStr} Outdated Homepage Carousel Tiles
+ Sent at ${new Date().toUTCString()}
`,
+ });
+ } catch (err) { console.error('[email]', err.message); }
+}
+
+async function sendSlackNotification(venues) {
+ if (!process.env.SLACK_WEBHOOK_URL) return;
+ try {
+ const blocks = venues.flatMap(v => {
+ const tiles = v.tiles.filter(t => t.status === 'outdated');
+ return [
+ { type: 'section', text: { type: 'mrkdwn', text: `*<${v.url}|${v.name}>* — ${tiles.length} outdated tile(s)` } },
+ { type: 'section', text: { type: 'mrkdwn', text: tiles.map(t => `• ${t.artist} — ~${t.dateStr}~`).join('\n') } },
+ ];
+ });
+ await axios.post(process.env.SLACK_WEBHOOK_URL, {
+ text: `:rotating_light: ${venues.length} venue(s) have outdated homepage tiles`,
+ blocks: [{ type: 'header', text: { type: 'plain_text', text: 'Outdated Homepage Carousel Tiles' } }, ...blocks],
+ });
+ } catch (err) { console.error('[slack]', err.message); }
+}
+
+async function sendWebhookNotification(venues) {
+ if (!process.env.WEBHOOK_URL) return;
+ try {
+ await axios.post(process.env.WEBHOOK_URL, {
+ event: 'outdated_tiles_detected',
+ timestamp: new Date().toISOString(),
+ venues: venues.map(v => ({ name: v.name, url: v.url,
+ outdatedTiles: v.tiles.filter(t => t.status === 'outdated') })),
+ });
+ } catch (err) { console.error('[webhook]', err.message); }
+}
+
+// ── API routes ────────────────────────────────────────────────────────────────
+
+app.get('/api/status', requireAuth, (req, res) => {
+ res.json({ venues: venueData, lastChecked, isScraping });
+});
+
+app.post('/api/refresh', requireAuth, (req, res) => {
+ res.json({ ok: true });
+ scrapeAll();
+});
+
+app.post('/api/refresh/:venue', requireAuth, (req, res) => {
+ res.json({ ok: true });
+ scrapeOne(decodeURIComponent(req.params.venue));
+});
+
+app.get('/api/events', requireAuth, (req, res) => {
+ res.setHeader('Content-Type', 'text/event-stream');
+ res.setHeader('Cache-Control', 'no-cache');
+ res.setHeader('Connection', 'keep-alive');
+ res.setHeader('X-Accel-Buffering', 'no');
+ res.flushHeaders();
+
+ const client = { id: Date.now(), res };
+ sseClients.push(client);
+
+ // Send current state immediately so the page is never blank
+ res.write(`data: ${JSON.stringify({
+ type: 'scrape_complete', data: venueData, lastChecked,
+ })}\n\n`);
+ if (isScraping) {
+ res.write(`data: ${JSON.stringify({ type: 'scraping_started', total: VENUES.length })}\n\n`);
+ }
+
+ const ping = setInterval(() => {
+ try { res.write(': ping\n\n'); } catch { clearInterval(ping); }
+ }, 15000);
+
+ req.on('close', () => {
+ clearInterval(ping);
+ const idx = sseClients.indexOf(client);
+ if (idx !== -1) sseClients.splice(idx, 1);
+ });
+});
+
+// ── Start ─────────────────────────────────────────────────────────────────────
+
+const PORT = process.env.PORT || 3000;
+app.listen(PORT, () => {
+ console.log(`\x1b[32m✓ Venue Carousel Tracker → http://localhost:${PORT}\x1b[0m`);
+ scrapeAll();
+});
+
+cron.schedule('0 * * * *', () => {
+ console.log('[cron] Hourly scrape triggered.');
+ scrapeAll();
+});