gitwtfhub

wtf is filebox?

yiwangxi32/filebox — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · generalComplexity · 2/5LicenseSetup · easy

TL;DR

FileBox is a local desktop and browser toolkit that compresses images, extracts password-protected archives, and packs files into ZIP or 7Z, all without a server.

Mindmap

mindmap
  root((FileBox))
    What it does
      Compresses images
      Extracts archives
      Creates archives
    Tech stack
      Next.js
      Electron
      TypeScript
    Use cases
      Batch image compression
      Password archive extraction
      Windows desktop app
    Audience
      General users
    Setup
      npm ci then npm run dev
      Optional Windows build

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Compress a batch of images and download the results without uploading them anywhere.

REASON 2

Extract a password-protected ZIP, RAR, or 7z archive and pull out only the files you need.

REASON 3

Pack a folder of files into a ZIP or 7Z archive with a custom name.

REASON 4

Run FileBox as a standalone Windows desktop app instead of a browser tab.

What's in the stack?

Next.jsReactTypeScriptElectronTailwind CSS

How it stacks up

yiwangxi32/filebox0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardeasy
Complexity2/54/52/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

No gotcha, npm ci followed by npm run dev starts it locally.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice and state changes.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Show me how to run npm ci and npm run dev to get FileBox running locally on port 3000.
Prompt 2
Help me package FileBox as a Windows desktop app using the dist:win-unpacked command.
Prompt 3
Explain how FileBox's archive extractor lets me selectively export files from a password-protected archive.
Prompt 4
Walk me through FileBox's project structure so I can add a new file processing tool.

Frequently asked questions

wtf is filebox?

FileBox is a local desktop and browser toolkit that compresses images, extracts password-protected archives, and packs files into ZIP or 7Z, all without a server.

What language is filebox written in?

Mainly TypeScript. The stack also includes Next.js, React, TypeScript.

What license does filebox use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice and state changes.

How hard is filebox to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is filebox for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.