Skip to content

nishal21/converter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

23 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌐 Universal File Converter - Web App

Universal File Converter React TypeScript Vite Tailwind

Transform any file format, anywhere, anytime - completely offline!

πŸš€ Live Demo β€’ πŸ“– Documentation β€’ 🀝 Contributing


✨ What Makes This Special?

πŸ”’ 100% Privacy-First - All conversions happen in your browser. Your files never leave your device.

⚑ Lightning Fast - No server uploads. No waiting. Instant conversions powered by WebAssembly.

🌍 Works Everywhere - Progressive Web App that works offline on any device with a browser.

🎨 Beautiful & Intuitive - Modern UI with drag-and-drop simplicity and mobile-responsive design.

🎯 Features

πŸ”„ Universal Format Support

Total:1000+

  • πŸ“„ Documents: PDF, DOCX, ODT, RTF, TXT, HTML, MD
  • πŸ–ΌοΈ Images: JPEG, PNG, WebP, GIF, BMP, TIFF, SVG, ICO
  • 🎡 Audio: MP3, WAV, OGG, FLAC, AAC, M4A
  • 🎬 Video: MP4, WebM, AVI, MOV, MKV, FLV
  • πŸ“¦ Archives: ZIP, RAR, 7Z, TAR, GZ
  • πŸ“Š Data: JSON, CSV, XML, YAML, SQL

πŸ› οΈ Powerful Editing Tools

  • πŸ“ Text Editor - Syntax highlighting, find/replace, multi-format export
  • 🎨 Image Editor - Crop, resize, filters, format conversion
  • 🎡 Audio Editor - Trim, volume control, format conversion
  • 🎬 Video Editor - Basic editing and format conversion
  • πŸ“„ PDF Viewer - View, extract text, basic annotations

πŸš€ Performance Features

  • ⚑ Batch Processing - Convert multiple files simultaneously
  • πŸ“± Mobile Optimized - Touch-friendly interface with hamburger navigation
  • πŸ”„ Real-time Preview - See changes as you make them
  • πŸ’Ύ Offline Capable - PWA with service worker for offline functionality

πŸ—οΈ Tech Stack


React 18

TypeScript

Vite

Tailwind CSS

Lucide Icons

Node.js

Monaco Editor

Fabric.js

πŸš€ Quick Start

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

# Clone the repository
git clone <repository-url>
cd universal-file-converter/web

# Install dependencies
npm install

# Start development server
npm run dev

Available Scripts

# πŸ”₯ Development with hot reload
npm run dev

# πŸ—οΈ Build for production
npm run build

# πŸ‘€ Preview production build
npm run preview

# πŸ” Lint code
npm run lint

# πŸ”§ Type checking
npm run type-check

πŸ“ Project Structure

web/
β”œβ”€β”€ πŸ“‚ public/           # Static assets
β”‚   β”œβ”€β”€ 🎨 icon.svg      # App logo
β”‚   └── πŸ“„ manifest.json # PWA manifest
β”œβ”€β”€ πŸ“‚ src/
β”‚   β”œβ”€β”€ πŸ“‚ components/   # Reusable UI components
β”‚   β”‚   β”œβ”€β”€ πŸ—‚οΈ Downloads.tsx
β”‚   β”‚   β”œβ”€β”€ πŸ“š UserGuide.tsx
β”‚   β”‚   └── πŸŽ₯ VideoTutorials.tsx
β”‚   β”œβ”€β”€ πŸ“‚ editors/      # File editors
β”‚   β”‚   β”œβ”€β”€ πŸ“ CodeEditor.tsx
β”‚   β”‚   β”œβ”€β”€ ✏️ TextEditor.tsx
β”‚   β”‚   β”œβ”€β”€ πŸ–ΌοΈ ImageEditor.tsx
β”‚   β”‚   β”œβ”€β”€ 🎡 AudioEditor.tsx
β”‚   β”‚   β”œβ”€β”€ 🎬 VideoEditor.tsx
β”‚   β”‚   └── πŸ“„ PDFViewer.tsx
β”‚   β”œβ”€β”€ πŸ“‚ pages/        # Application pages
β”‚   β”‚   β”œβ”€β”€ 🏠 LandingPage.tsx
β”‚   β”‚   β”œβ”€β”€ πŸ”„ ConverterPage.tsx
β”‚   β”‚   β”œβ”€β”€ ✏️ EditorPage.tsx
β”‚   β”‚   β”œβ”€β”€ πŸ“‹ FormatsPage.tsx
β”‚   β”‚   └── πŸ› οΈ APIPage.tsx
β”‚   β”œβ”€β”€ πŸ“‚ utils/        # Utility functions
β”‚   └── πŸ“„ App.tsx       # Main application
β”œβ”€β”€ πŸ“¦ package.json      # Dependencies
└── βš™οΈ vite.config.ts    # Vite configuration

🎨 Key Features Walkthrough

1. 🏠 Landing Page

  • Hero Section - Animated feature showcase
  • Format Grid - Visual representation of 1000+ supported formats
  • Statistics - Real-time animated counters
  • Mobile Navigation - Hamburger menu for mobile devices

2. πŸ”„ Converter Page

  • Drag & Drop Zone - Intuitive file upload
  • Format Selection - Smart format detection and suggestion
  • Batch Processing - Handle multiple files at once
  • Progress Tracking - Real-time conversion progress

3. ✏️ Editor Suite

  • Code Editor - Monaco-powered with syntax highlighting
  • Image Editor - Fabric.js canvas with filters and tools
  • Audio/Video Editor - Basic editing capabilities
  • PDF Viewer - React-PDF integration

4. πŸ“± Mobile Experience

  • Responsive Design - Mobile-first approach
  • Touch Optimized - Large touch targets, swipe gestures
  • PWA Ready - Install as native app
  • Offline Support - Works without internet

πŸ”§ Configuration

Environment Variables

Create a .env file in the web directory:

VITE_APP_NAME=Universal File Converter
VITE_APP_VERSION=1.0.0
VITE_PWA_ENABLED=true

PWA Configuration

The app includes Progressive Web App features:

  • Service Worker for offline functionality
  • Web App Manifest for installability
  • Responsive design for all devices

🎯 Browser Support

Browser Version Status
Chrome 90+ βœ… Full Support
Firefox 88+ βœ… Full Support
Safari 14+ βœ… Full Support
Edge 90+ βœ… Full Support

🀝 Contributing

We welcome contributions! Here's how to get started:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add amazing feature'
  4. Push to the branch: git push origin feature/amazing-feature
  5. Open a Pull Request

Development Guidelines

  • Follow TypeScript best practices
  • Use Tailwind CSS for styling
  • Ensure mobile responsiveness
  • Add proper error handling
  • Write meaningful commit messages

πŸ“ License

MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

  • React Team - For the amazing framework
  • Tailwind CSS - For the utility-first CSS framework
  • Lucide Icons - For the beautiful icon set
  • Monaco Editor - For the code editing experience
  • Fabric.js - For canvas manipulation
  • Vite - For the lightning-fast build tool

Made with ❀️ for developers and creators worldwide

⭐ Star this project β€’ πŸ› Report Bug β€’ πŸ’‘ Request Feature

About

Transform any file format, anywhere, anytime - completely offline!

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages