Skip to content

Fred56733/Cleaner-Contacts

Repository files navigation

Contact-Manager-logo

Contact-Management-Project

🚀 Overview

Cleaner Contact is a powerful web application designed to streamline contact management. Upload messy CSV or vCard files and get clean, organized contact data in seconds. Perfect for professionals, businesses, or anyone dealing with large contact lists that need cleaning and organization.

Built with: React.js, JavaScript, CSS3
Time Invested: ⏳ 280+ hours and counting...


🛠 Key Features

Smart Contact Cleaning

  • Duplicate Detection & Removal - Automatically identifies and removes duplicate contacts based on email, phone, or name
  • Phone Number Normalization - Standardizes phone numbers to consistent formats
  • Data Validation - Flags incomplete or invalid contact information
  • Email Validation - Ensures email addresses follow proper formatting

Multi-Format Support

  • CSV Import/Export - Handle standard CSV contact files
  • vCard Support - Import and convert .vcf files seamlessly
  • Excel Export - Download cleaned data as Excel spreadsheets
  • JSON Export - Export data in JSON format for developers

File Merging

  • Multi-File Processing - Upload and merge multiple contact files
  • Conflict Resolution - Smart handling of conflicting contact information
  • Bulk Operations - Process thousands of contacts efficiently

Real-Time Analytics

  • Cleaning Summary - See exactly what was cleaned and removed
  • Data Insights - Statistics on duplicates, invalid entries, and corrections
  • Visual Feedback - Clear indicators of cleaning progress and results

Modern Interface

  • Drag & Drop - Intuitive file uploading experience
  • Live Search - Filter and find contacts instantly
  • Responsive Design - Works perfectly on desktop and mobile
  • Glass Morphism UI - Beautiful, modern design with smooth animations

🔧 Technical Features

File Processing

  • Large File Support - Handle files with thousands of contacts
  • Memory Efficient - Optimized processing for better performance
  • Error Handling - Graceful handling of corrupted or malformed files

Data Cleaning Algorithms

  • Fuzzy Matching - Identifies similar contacts that might be duplicates
  • Smart Parsing - Handles various contact file formats and structures
  • Validation Rules - Comprehensive checks for data integrity

Export Options

  • Multiple Formats - CSV, Excel, JSON, vCard
  • Custom Fields - Choose which fields to include in exports

Safety & Privacy

  • No External APIs - All processing happens locally in your browser
  • Zero Data Storage - Your contact files are never saved or stored on our servers
  • Complete Privacy - No data leaves your device during the cleaning process
  • Offline Capable - Download and run locally for maximum security
  • Open Source - Full transparency with publicly available code

📥 Download (No coding required)

We publish signed builds on GitHub Releases.

Go to Releaseslatest version.

Under Assets, download the installer for your OS:

  • CleanerContacts-Setup-x64.exe (Windows)
  • CleanerContacts-darwin-x64.dmg (macOS Intel) / CleanerContacts-darwin-arm64.dmg (Apple Silicon)
  • CleanerContacts-linux-x86_64.AppImage (Linux)

Open the installer and launch Cleaner Contacts.


🔗 Demo & Links


👥 Team

  • Frederick DeBiase — Team Lead
  • Talon Farmer
  • Isaiah Cruz
  • Melvin Ho
  • Mark Reece

⚖ License

Copyright [2024] [Group: Frederick DeBiase, Melvin Ho, Talon Farmer, Mark Reece, Isaiah Cruz]

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •