first push

2026-06-04 16:20:56 -05:00
parent a663de4f29
commit 392ae7bbe3
111 changed files with 5312 additions and 0 deletions
@@ -0,0 +1,82 @@
+---
+type: project
+status: active
+source: git.alwisp.com
+repo: jason/pnger
+repo_url: https://git.alwisp.com/jason/pnger
+language: Svelte
+branch: main
+tags:
+  - repo
+  - jason
+  - alwisp
+updated: 2026-05-29
+---
+
+# pnger
+
+**Repository:** [jason/pnger](https://git.alwisp.com/jason/pnger) · branch `main` · Svelte
+
+## Summary
+
+Modern PNG editor & resizer with live preview, drag & drop, smart presets, keyboard shortcuts, and dark/light themes. TypeScript + Svelte + Sharp. Deployed on Unraid.
+
+## Current status
+
+Active. Synced from Gitea on 2026-05-29.
+
+## Documentation overview
+
+# PNGer - Modern PNG Editor & Resizer
+
+A sleek, modern PNG editor and resizer with **live preview**, **drag & drop**, **smart presets**, **keyboard shortcuts**, and **dark/light mode theming**. Built with TypeScript and optimized for deployment as a single Docker container.
+
+## ✨ Features
+
+- **🎨 Modern UI**: Beautiful dark/light mode for inspecting transparency.
+- **⚡ Live Preview**: Instant side-by-side comparison with file size analysis.
+- **🚀 Efficiency**: Drag & Drop upload, clipboard paste (`Ctrl+V`), and smart presets.
+- **🖼️ Precision**: Control width, height, quality, and crop positions (9 modes).
+- **📦 Reliable Deployment**: Multi-stage Docker build optimized for Unraid and Gitea.
+
+## 🚀 Quick Start
+
+### Docker/Unraid Deployment
+1. **Clone & Build**:
+   ```bash
+   git clone https://git.alwisp.com/jason/pnger.git
+   cd pnger
+   docker build -t pnger:latest .
+   ```
+2. **Run**:
+   ```bash
+   docker compose up -d
+   ```
+3. **Access**: `http://localhost:8080` (or your Unraid IP)
+
+### Local Development
+1. **Install & Run Backend**: `cd backend && npm install && npm run dev`
+2. **Install & Run Frontend**: `cd frontend && npm install && npm run dev`
+3. **Access**: `http://localhost:5173`
+
+## 📚 Documentation
+
+For more detailed information, please refer to:
+- **[INSTRUCTIONS.md](./INSTRUCTIONS.md)**: Technical architecture, development setup, code standards, and troubleshooting.
+- **[ROADMAP.md](./ROADMAP.md)**: Project history, sprint updates, and future feature plans.
+
+## ⌨️ Keyboard Shortcuts
+
+- `Ctrl+V`: Paste image from clipboard
+- `Enter`: Download (when input not focused)
+- `?`: Show shortcuts help
+- `Esc`: Close dialogs
+
+---
+
+**License**: MIT  
+**Repository**: [https://git.alwisp.com/jason/pnger](https://git.alwisp.com/jason/pnger)
+
+## Notes
+
+- Project file auto-created from repo documentation.