Death Timers - Mob Tracker

A simple, modern single-file web app for tracking mob death timers and respawn countdowns. Built with Alpine.js and Tailwind CSS.

🌐 Live Demo

Visit the live app: https://[YOUR-USERNAME].github.io/death-timers/

Replace [YOUR-USERNAME] with your GitHub username

🚀 Deploy to GitHub Pages

This app automatically deploys to GitHub Pages using GitHub Actions!

Quick Setup:

1. Fork/Clone this repository
2. Enable GitHub Pages:
   • Go to repository Settings → Pages
   • Set Source to "GitHub Actions"
   • Save settings
3. Push to main branch - app deploys automatically!

Deployment Features:

• ✅ Auto-deploy on every push to main/master
• ✅ Manual trigger from GitHub Actions tab
• ✅ No build step - deploys static HTML directly
• ✅ Fast deployment - usually 1-2 minutes

Making Updates:

# Make your changes to index.html
git add index.html
git commit -m "Update death timers app"
git push origin main

The app automatically redeploys in 1-2 minutes!

Troubleshooting:

• Deployment failed? Check Actions tab for error details
• App not loading? Verify CDN links and clear browser cache
• Audio not working? Click anywhere to enable audio, check console for errors

Features

• ⚔️ Add/Delete Mobs: Create mob trackers with custom names
• ⏱️ Death Recording: Record death timestamps with one click
• ⏰ Respawn Timers: Set custom respawn times (in minutes) per mob
• ⏳ Countdown Display: Visual countdown with progress bar and urgent alerts
• 🔊 Audio Notifications: Warning at 1 minute, ticks for last 20 seconds
• 💾 Persistent Storage: All data saved to localStorage
• 🌙 Dark Mode: Toggle between light and dark themes
• 📱 Responsive: Works on desktop, tablet, and mobile
• 🧹 Record Management: Clear all records or individual timestamps

Getting Started

Option 1: Use the Live App

Just visit the GitHub Pages URL above - no installation needed!

Option 2: Direct File Access

Simply open index.html in your web browser - no build process required!

Option 3: Development Server (Recommended)

For live reload during development:

1. Install dependencies:

   npm install

2. Start the development server:

   npm run dev

3. Open your browser to http://localhost:3000

How to Use

1. Add a Mob: Click "Add Mob" and enter the mob name
2. Set Respawn Timer: Adjust the timer value (in minutes) for each mob
3. Record Death: Click "Record Death" to log a timestamp and start the countdown
4. Manage Records: Clear all records or remove individual timestamps
5. Stop Countdown: Click the "✕" on the countdown to stop it early

Technology Stack

• Alpine.js - Reactive JavaScript framework (CDN)
• Tailwind CSS - Utility-first CSS framework (CDN)
• Inter Font - Modern typography from Google Fonts
• LocalStorage - Persistent data storage
• Web Audio API - Generated sound effects
• Native JavaScript - No build tools required

Browser Support

Works in all modern browsers that support:

• ES6+ JavaScript
• CSS Grid and Flexbox
• LocalStorage API
• Web Audio API

License

MIT