Skip to content

Privacy-first browser toolkit with 45+ utilities. File sharing, image processing, text tools, and data generators, all running client-side. Built with React and TypeScript.

Notifications You must be signed in to change notification settings

ndycode/vxid.cc

Repository files navigation

vxid.cc

A privacy-first toolkit with 64+ browser utilities. All tools run client-side — no sign-ups, no tracking, just practical tools for developers and creators.

Features

Core Capabilities

  • Checker Tools — IP lookup, DNS records, WHOIS, SSL check, ping, user agent, screen info, leak detection
  • File Sharing — Dead drop with 6-digit codes, optional passwords, and auto-expiry
  • Sharing Tools — Link shortener, pastebin, image host, secret notes, code/JSON/CSV sharing
  • Image Processing — Compress, resize, convert, crop, blur, rotate, filter, remove backgrounds
  • Text Utilities — Word count, case conversion, regex tester, Lorem ipsum, base64 encoding
  • Data Generators — Passwords, UUIDs, timestamps, gradients, barcodes, test data

User Experience

  • Favorites — Bookmark frequently-used tools with the heart icon
  • Recent Tools — Quick access to your last 6 used tools
  • Keyboard ShortcutsEsc to go back, Cmd/Ctrl+K for search, arrow keys to navigate
  • Animated Background — Subtle floating gradient orbs for visual polish
  • Skeleton Loaders — Smooth shimmer loading states
  • Success Animations — Confetti feedback on key actions

Tech Stack

Layer Technology Purpose
Framework Next.js 15 (App Router) Server/client React with TypeScript
Storage Cloudflare R2 Object storage for file sharing
Styling Tailwind CSS v4 Utility-first CSS
Components shadcn/ui Accessible UI primitives
Animations Framer Motion UI transitions
Color Picker react-colorful Custom color selection
Effects canvas-confetti Success animations

Quick Start

# Clone and install
git clone https://github.com/ndycode/vxid.cc.git
cd vxid.cc
npm install

# Configure environment (optional, for file sharing)
cp .env.example .env.local
# Edit .env.local with your R2 credentials

# Start development server
npm run dev

Visit http://localhost:3000

Project Structure

├── app/
│   ├── page.tsx              # Landing + tools carousel
│   ├── s/[code]/page.tsx     # Share viewer
│   └── api/                  # Upload/download/share APIs
├── components/
│   ├── tools/                # 64 tool components
│   ├── tools-carousel.tsx    # Navigation with favorites/recent
│   ├── animated-background.tsx
│   └── ui/                   # shadcn + custom components
└── lib/
    ├── tools-config.ts       # Tool definitions
    ├── tool-preferences.ts   # Favorites/recent (localStorage)
    └── confetti.ts           # Animation utilities

Environment Variables

R2_ACCOUNT_ID=your_account_id
R2_ACCESS_KEY_ID=your_access_key
R2_SECRET_ACCESS_KEY=your_secret_key
R2_BUCKET_NAME=your_bucket_name
R2_PUBLIC_URL=your_public_url

Available Scripts

Command Description
npm run dev Start development server
npm run build Create production build
npm run start Start production server
npm run lint Run ESLint
npm run format Format code with Prettier
npm test Run test suite
npm run test:coverage Run tests with coverage
npm run typecheck Check TypeScript types

Tools (64)

Checker (11)

ip, dns, whois, ssl, ping, useragent, screen, cookies, webgl, password, leak

Sharing (9)

drop, qr, shorten, paste, imghost, secret, code, json, csv

Generate (16)

pass, color, barcode, fake, palette, card, string, integer, sequence, username, business, iban, mac, hash, uuid, gradient

Text (14)

count, case, clean, emoji, days, dedup, reverse, chars, numbers, lorem, base64, regex, timestamp, privacy

Image (14)

compress, resize, convert, favicon, erase, crop, split, svg, pick, watermark, ratio, blur, rotate, filter

Design Principles

  1. Client-side first — All processing in the browser
  2. Dark mode default — With optional light theme
  3. Mobile-first — Responsive design throughout
  4. No sign-ups — Preferences stored in localStorage
  5. Instant feedback — No blocking modals or toasts

License

MIT

About

Privacy-first browser toolkit with 45+ utilities. File sharing, image processing, text tools, and data generators, all running client-side. Built with React and TypeScript.

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published