glitchcraft/README.md

# Ǧ̴̝̲̙̱̳̗̱͊̒̀̀̀l̶̰̲̯̗̾̊͌̀̊̃̓̚i̴̧̘͕̺͉̘̇̃̄̏͂̃͛̎̐t̷̢̨̙̗̞̯͖̗̳͌c̷̖͓̟̞͋h̷̨̻̝̻̩̼̤̣̟̓͗̑͝C̴̺̺̘͍̙̈͐̀̾̔̈́̒̃r̷̢̧̢̛̬̱̻̝̭̈́̍̐͒̇ā̸̤̜͌̓̋̉̓̉̚f̸̘̘̤͙̠̈́̐̍̀͋͊̕͝t̸̨̹̪̭̲̮̗̳̽̎

> **Artisanal text corruption, served fresh!**

Transform your boring text into b̴̧̧̯̰̲̤̫̲͇̅̀̓̆̈́̈́̄̀e̵̫̥̱̿̾̊̉͊́̚a̸̫̺̘̤̰̝̿̐̍͗̇̋u̸̢̳̝̯̲̮̦̇̍̔̈́̎̊t̸̨̲̘̺̹̙̋͆̀̅̚i̸̧̦̩̥̫̭̬̍̑̎́̒f̵̰̰̺̹̤̋ù̴̧̡̢̘̱̇͛̉̇̂͌l̶̺̩̰̥̀̉̄̄̈́͝ć̵̨̧̦̞̤̤̠̃́̔̀͝h̴̭̙̋̊̾͛́a̴̻̦̹̰̖̅̀͌̃ō̴̳̜̝̮͇͍̄̓̋͌̍̔s̷̘̺̤̩͂̽̌̅̈͠! GlitchCraft is a Progressive Web App that generates zalgo text using Unicode combining characters.

## ✨ F̴̛̪̞̯̀̔́ͅe̷̮̮̗̣̎a̸̤̺̜̾̃̓͜t̶̛̘̝̾u̴̢̬͇̒ṛ̴̭̖̈́e̷̲̺̔̓͝ş̷̝̑̀

- **🎨 Six Corruption Modes**: From subtle glitches to complete chaos
- **📱 Mobile-First Design**: Perfect experience on all devices  
- **⚡ Real-Time Generation**: See corruption as you type
- **📋 One-Click Copy**: Tap the output to copy instantly
- **🔧 Adjustable Intensity**: Fine-tune your chaos level (1-10)
- **💾 PWA Ready**: Install as an app, works offline
- **🌐 Universal Support**: Works on all modern browsers

## 🎭 Corruption Modes

| Mode | Example | Description |
|------|---------|-------------|
| **Full Chaos** | ĥ̵̝̮̀è̸̘̩l̴̹̩̔l̵̲̎ô̶̰ ̷̳̎w̸̰̄o̶̜̅r̷̰̄l̴̨̾d̶̰̈ | Balanced corruption above, middle, and below |
| **Above Only** | h̸̘̤́ë̸́l̴̮̆l̸̘̀ö̴́ ̶̘̀w̴̮̌ö̴́ř̶̰l̴̮̀d̸̮̆ | Marks above characters only |
| **Below Only** | h̴̖̆ë̵l̵̰l̵̲ö̴ ̷̰w̴̰ö̴̰r̴̲l̵̲d̴̰ | Marks below characters only |
| **Middle Only** | h̶e̷l̷l̶o̵ ̴w̵o̴r̷l̴d̵ | Marks overlaying characters |
| **Mini Glitch** | ḧ̴e̵l̴l̷o̵ ̴w̶o̴r̷l̴d̵ | Subtle corruption |
| **Heavy Corruption** | h̸̨̬̘̤̖̱̗̘̄̀́̌̈́̀̇̚ë̴̛̖̘̩̰̱̳̤́̓̒̚l̷̢̧̰̲̫̲̝̹̈́̔̃̀̈́̇̚l̴̢̧̰̲̫̲̝̹̈́̔̃̀̈́̇̚ö̴́̓̒̚ ̷̰̔̈́w̸̰̄̌ö̴́̓̒̚r̷̰̄̌l̴̰̔̈́d̶̰̈́̌ | Maximum chaos overload |

## 🚀 Quick Start

### 🌐 Online
Visit the deployed app at: **[Your deployment URL]**

### 💻 Local Development

```bash
# Clone the repository
git clone <your-repo-url>
cd zalgo

# Install dependencies
just install
# or: bun install

# Start development server
just serve
# or: python3 server.py

# Open http://localhost:8000
```

## 🛠️ Development

### Prerequisites
- **Bun** (for dependencies and linting)
- **Python 3** (for development server)
- **Just** (for task automation, optional)

### Available Commands

```bash
# Development
just serve              # Start development server
just serve-bg           # Start server in background
just stop               # Stop background server

# Code Quality
just lint-all           # Lint JavaScript and Python
just format-all         # Format all code
just check-all          # Run all linting and validation

# Testing & Validation
just validate           # Full validation suite
just validate-references # Check file references exist
just validate-html      # Validate HTML (requires Java)
just validate-manifest  # Validate PWA manifest

# PWA Icons
just icons-png          # Generate PNG icons (requires canvas)
just icons-browser      # Open browser icon generator

# Project Info
just info               # Show project information
just status             # Check server status
```

## 📱 Mobile Experience

GlitchCraft is designed mobile-first with:

- **Touch-optimized controls** with larger touch targets
- **Responsive layout** that adapts from 320px to 4K
- **iOS zoom prevention** with proper font sizes
- **Haptic feedback** for copy actions (where supported)
- **Full-screen support** when installed as PWA
- **Offline functionality** via service worker

### Mobile Features
- Tap output text to copy instantly
- Swipe-friendly interface
- Portrait and landscape support
- Works great on tablets

## 🔧 Technical Details

### Architecture
- **Pure JavaScript** - No frameworks, maximum performance
- **Service Worker** - Full offline support with cache-first strategy
- **Progressive Enhancement** - Works without JavaScript
- **Accessible** - Screen reader compatible, keyboard navigation

### Zalgo Algorithm
The corruption engine uses Unicode combining diacritical marks from three categories:
- **Above** (U+0300-U+036F): Accents and marks above characters
- **Middle** (U+0315-U+0489): Overlaying marks  
- **Below** (U+0316-U+0359): Marks below characters

Each mode strategically applies different combinations for unique effects.

### Browser Support
- ✅ Chrome/Chromium 88+
- ✅ Firefox 85+
- ✅ Safari 14+
- ✅ Edge 88+
- ✅ Mobile browsers (iOS Safari, Chrome Mobile)

## 🎨 Examples

Here are some z̴̳̈a̸̭̾l̵̰̔g̶̱̈ó̴̬ ̷̲̎t̸̰̄e̶̮̾x̷̲̄ẗ̴̰ examples:

### Normal Text → Corrupted
```
Hello World → H̸̖̄e̶̮̾l̵̰̔ḻ̶̈ó̴̬ ̷̲̎W̸̰̄ö̶̮̾r̵̰̔ḻ̶̈d̴̬̈

Welcome to GlitchCraft → Ẁ̴̛̪̞̯̔́ͅe̷̮̮̗̣̎l̴̹̩̔c̸̘̩̀ö̴̝̮̀m̵̲̎ë̸̘̩ ̶̰̔t̷̳̎ő̶̰ ̴̨̾G̴̮̀l̸̘̀i̵̲t̴̖̆c̵̰h̴̘Č̶̮r̴̮̀a̵̲f̴̰t̸̮̆

The quick brown fox → T̷̨̄h̶̨̍ë̴́ ̵̌q̷̇ű̴i̸̇c̸̈ǩ̶ ̴̈b̵̄ř̷ö̴́ẇ̸n̶̈ ̴̌f̷̄ö̴́ẋ̸
```

### Heavy Corruption Mode
```
CHAOS → C̸̨̧̬̘̤̖̱̗̘̄̀́̌̈́̀̇̚Ḧ̷̢̧̰̲̫̲̝̹́̔̃̀̈́̇̚Ä̴̢̧̰̲̫̲̝̹́̔̃̀̈́̇̚Ö̷̰́̓̒̚S̷̰̔̈́
```

## 🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run `just check-all` to ensure quality
5. Submit a pull request

## 📄 License

MIT License - Feel free to use this for your own projects!

## 🎭 Fun Facts

- The name "zalgo" comes from a creepypasta character
- Unicode combining characters were designed for legitimate text rendering
- GlitchCraft generates infinite unique corruptions
- The glitch animations are pure CSS - no JavaScript!
- Works offline once loaded (thanks to service worker)

---

**Made with ❤️ and ḉ̴̨̧̰̲̫̲̝̹̈́̔̃̀̈́̇̚h̷̰̔̈́ä̸̰́̌ō̶̰̔̈́s̷̰̔̈́**

*Transform your text, embrace the glitch, spread the chaos!*