yiwangxi32/filebox

FileBox is a local file utility toolkit that bundles three common file processing tasks into a single desktop and browser application. It focuses on three high-frequency scenarios: compressing images, extracting archive files, and creating new archives from files or folders. The image compressor lets you upload multiple images at once, adjust quality or size settings, and download the compressed results. The archive extractor supports ZIP, RAR, and 7z formats including password-protected archives, and lets you selectively pick which files inside the archive to export rather than extracting everything. The archive creator lets you select files or folders and pack them into ZIP or 7Z format with a custom output name. The app is designed to run locally rather than uploading your files to a server. It runs in a browser during development, and can also be packaged as a Windows desktop application so you have a proper app experience without needing a browser tab. The tech stack is Next.js 14 and React 18 with TypeScript for the front-end, Electron for the desktop packaging, Tailwind CSS and Radix UI for the interface components, and Vitest plus Playwright for testing. The project is licensed under Apache-2.0. Getting it running locally starts with npm ci to install dependencies, then npm run dev, which opens a development server on port 3000 by default, or npm run dev:3001 for an alternate port. Each tool has its own route: the image compressor lives at /tools/image-compressor, the archive extractor at /tools/archive-extractor, and the archive creator at /tools/archive-compressor. The codebase is organized into an app folder for pages and routes, a components folder for interface pieces, a lib folder for the core processing logic, an electron folder for the desktop packaging scripts, and a tests folder for unit and end-to-end coverage.