Releases: Shivanshmishra7275/Contact-Forge
Release list
🚀 ContactForge v4.3.0
🚀 ContactForge v4.3.0 — Hotfix + Premium Design Overhaul
This release contains critical stability fixes from the v4.0.0 launch, a sweeping UI/UX design overhaul, and major bugfixes to the Power Cleanup UI.
🔥 Critical Fixes (v4.3.0)
🪲 Fixed: Android Aurora SVG Crash
Android's SVG rendering engine silently failed when animating AnimatedRadialGradient via useAnimatedProps, resulting in a completely black screen instead of the Premium Design Aurora background. Completely rewrote the animation engine to use native static SVGs wrapped in Animated.View transforming matrices. The background now breathes at a buttery 60 FPS on Android.
🪲 Fixed: "Missing critical contact field" UI Bug in Power Cleanup
The Power Cleanup UI mistakenly grouped ANY contact missing an email address into the "Incomplete" tab. This completely hid their fixable formatting errors (like Duplicate Numbers and Missing Country Codes), and disabled the "Fix Formatting" bulk action. Refactored the internal mapping logic to strictly separate formatting and incomplete issues, enabling bulk-formatting automation for all 1600+ contacts.
🪲 Fixed: App crash on upgrade (schema migration race condition)
Users upgrading from v3.3 to v4.0.0 encountered a fatal crash loop. The root cause was a SQLite schema migration executing CREATE INDEX ON contacts(name_key) before the migration that added the name_key column. This caused a no such column fatal error that cascaded into:
- Every sync crashing with "no such column: name_key"
- Terms & Conditions screen showing on every launch (settings couldn't load)
- Magic Merge All button crashing
Fix: Reordered schema bootstrap so COLUMN_MIGRATIONS always run before CREATE_INDEXES.
🪲 Fixed: Library Health always showing 0%
Health was calculated by running 5 DB queries per contact × 1800 contacts = 9,000+ DB round trips — which silently timed out. Replaced with a single SQL AVG() aggregation query.
🪲 Fixed: Splash screen text truncation
The typewriter loading text was being clipped mid-word on some Android screen densities. Fixed with proper layout constraints.
🪲 Fixed: Magic Merge All nested transaction crash
A massive regression where clicking "Magic Merge All" caused an immediate crash with cannot rollback - no transaction is active. This was due to an expo-sqlite limitation where a nested transaction inside reassignRelationships conflicted with the parent bulk merge transaction. Stripped out the nested wrapper so the merge executes smoothly within a single atomic commit.
🪲 Fixed: Website APK Download Timeout (504 Gateway Error)
Users downloading the 92MB APK from the website frequently experienced a failed download. Vercel serverless functions have a 10s execution limit, causing the stream to forcibly timeout. Refactored the /api/download route to track analytics via Redis and immediately HTTP 302 redirect directly to the GitHub CDN, allowing full high-speed downloads directly from S3.
✨ New: Premium Design System v4.3.0
A complete visual overhaul based on WCAG AA accessibility standards and 2025 mobile design trends:
🎨 Color System & UI
- Richer background: Deep navy eliminates harsh halation
- WCAG AA compliant text: All text colors verified to 4.5:1+ contrast ratio
- 3-Layer Aurora Background: Three breathing radial gradients (violet, teal, indigo) that slowly drift.
- Glass Cards 2.0: Cards now have proper box shadow depth and subtle border edges.
- Tab Bar Overhaul: Solid opaque background, proper elevation shadow, active tint.
- Automatic First Sync: On first launch with contacts permission, the app automatically begins syncing.
📥 Getting Started
Download the APK below, or clone the repository to run locally on Expo Go.
📦 Asset Details
- File:
ContactForge-v4.3.0.apk - Size: ~92 MB
- SHA-256:
6CEC19FAF9CFB6352DC8424994352E5F762B391EE972C18A2AB492449E506FF0
Architected with 🖤 by Shivansh Mishra
Building privacy-first mobile systems with modern local-first architecture.
🚀 ContactForge v4.2.0 — Hotfix + Premium Design Overhaul
🚀 ContactForge v4.2.0 — Hotfix + Premium Design Overhaul
This release contains critical stability fixes from the v4.0.0 launch and a sweeping UI/UX design overhaul.
🔥 Critical Fixes (v4.2.0)
🪲 Fixed: App crash on upgrade (schema migration race condition)
Users upgrading from v3.3 to v4.0.0 encountered a fatal crash loop. The root cause was a SQLite schema migration executing CREATE INDEX ON contacts(name_key) before the migration that added the name_key column. This caused a no such column fatal error that cascaded into:
- Every sync crashing with "no such column: name_key"
- Terms & Conditions screen showing on every launch (settings couldn't load)
- Magic Merge All button crashing
Fix: Reordered schema bootstrap so COLUMN_MIGRATIONS always run before CREATE_INDEXES.
🪲 Fixed: Library Health always showing 0%
Health was calculated by running 5 DB queries per contact × 1800 contacts = 9,000+ DB round trips — which silently timed out. Replaced with a single SQL AVG() aggregation query.
🪲 Fixed: Splash screen text truncation
The typewriter loading text was being clipped mid-word on some Android screen densities. Fixed with proper layout constraints.
🪲 Fixed: Magic Merge All nested transaction crash
A massive regression where clicking "Magic Merge All" caused an immediate crash with cannot rollback - no transaction is active. This was due to an expo-sqlite limitation where a nested transaction inside reassignRelationships conflicted with the parent bulk merge transaction. Stripped out the nested wrapper so the merge executes smoothly within a single atomic commit.
🪲 Fixed: Website APK Download Timeout (504 Gateway Error)
Users downloading the 92MB APK from the website frequently experienced a failed download. Vercel serverless functions have a 10s execution limit, causing the stream to forcibly timeout. Refactored the /api/download route to track analytics via Redis and immediately HTTP 302 redirect directly to the GitHub CDN, allowing full high-speed downloads directly from S3.
✨ New: Premium Design System v4.2.0
A complete visual overhaul based on WCAG AA accessibility standards and 2025 mobile design trends:
🎨 Color System & UI
- Richer background: Deep navy eliminates harsh halation
- WCAG AA compliant text: All text colors verified to 4.5:1+ contrast ratio
- 3-Layer Aurora Background: Three breathing radial gradients (violet, teal, indigo) that slowly drift.
- Glass Cards 2.0: Cards now have proper box shadow depth and subtle border edges.
- Tab Bar Overhaul: Solid opaque background, proper elevation shadow, active tint.
- Automatic First Sync: On first launch with contacts permission, the app automatically begins syncing.
📥 Getting Started
Download the APK below, or clone the repository to run locally on Expo Go.
📦 Asset Details
- File:
ContactForge-v4.2.0.apk - Size: ~92 MB
- SHA-256:
ACEE059F4EBF2D055BADB3B6D3C76B944E7FD123B2BD81F6C61A4C2A093FBB8B
Architected with 🖤 by Shivansh Mishra
Building privacy-first mobile systems with modern local-first architecture.
ContactForge v4.1.0
🚀 ContactForge v4.0.1: The Complete CRM & Write-Back Sync Release
We are thrilled to announce ContactForge v4.0.1 — our biggest and most feature-rich update yet!
(Note: v4.0.1 contains a critical hotfix for upgrading users that resolves crash loops and "no such column: name_key" sync errors from the v4.0.0 release).
🔥 What's New in v4.0.0 & v4.0.1?
🔄 2-Way Native OS Write-Back Sync
ContactForge is no longer an isolated island. With the new Write Back to Phone feature in the Mission Control Dashboard, you can push your perfectly cleaned, merged, and enhanced Contact-Forge library directly back to your iOS or Android native address book. Clean up duplicates here, and let the changes reflect everywhere!
📝 Full CRM Contact Editing
You no longer need to jump to your phone's native address book to fix typos. We've added a dedicated Edit Contact screen. Tap the Pencil Icon in the top right of any Contact's Detail page to dynamically edit their name, company, job title, notes, and tags.
🫨 Shake-to-Undo Global Gesture
Accidentally merged the wrong contacts? Accidentally deleted someone? Just physically shake your phone! We've integrated hardware accelerometer sensors to trigger a premium global Undo action, complete with haptic feedback.
📤 Single Contact VCF Sharing
While bulk export is great for backups, sometimes you just need to share a single person's info. We've added a Share Contact Card button in the Contact Details screen. Tap it to instantly generate a .vcf file and pop up the native iOS/Android share sheet.
🎬 Cinematic UI & FlashList Virtualization
We've completely overhauled the list rendering engines using Shopify's FlashList, guaranteeing buttery-smooth 60fps scrolling even with 2,000+ contacts. Plus, we've injected react-native-reanimated physics, giving lists a beautiful cascading fade-in effect. Dark mode colors have also been tweaked for optimal WCAG accessibility and premium aesthetics.
🛠️ Previous Highlights (v3.3)
- SQLite FTS5 Indexed Search: Microsecond filtering across tens of thousands of contacts.
- Zero-Loss Tombstone Sync Architecture: Safe deletions and flawless sync propagation.
- Bulk Action Multi-Select: Mass delete and mass export capabilities.
- Safe Merge Memory: Persistent 'Ignore Duplicate' functionality.
📥 Getting Started
Download the latest signed APK from the assets below, or clone the repository to run it locally on Expo. No servers. No cloud. Just your data, perfectly synced.
Architected with 🖤 by Shivansh Mishra
Building privacy-first mobile systems with modern local-first architecture.
ContactForge v4.2.0
🚀 ContactForge v4.2.0 — Hotfix + Premium Design Overhaul
This release contains critical stability fixes from the v4.0.0 launch and a sweeping UI/UX design overhaul.
🔥 Critical Fixes (v4.2.0)
🪲 Fixed: App crash on upgrade (schema migration race condition)
Users upgrading from v3.3 to v4.0.0 encountered a fatal crash loop. The root cause was a SQLite schema migration executing CREATE INDEX ON contacts(name_key) before the migration that added the name_key column. This caused a no such column fatal error that cascaded into:
- Every sync crashing with "no such column: name_key"
- Terms & Conditions screen showing on every launch (settings couldn't load)
- Magic Merge All button crashing
Fix: Reordered schema bootstrap so COLUMN_MIGRATIONS always run before CREATE_INDEXES.
🪲 Fixed: Library Health always showing 0%
Health was calculated by running 5 DB queries per contact × 1800 contacts = 9,000+ DB round trips — which silently timed out. Replaced with a single SQL AVG() aggregation query.
🪲 Fixed: Splash screen text truncation
The typewriter loading text was being clipped mid-word on some Android screen densities. Fixed with proper layout constraints.
🪲 Fixed: Magic Merge All nested transaction crash
A massive regression where clicking "Magic Merge All" caused an immediate crash with cannot rollback - no transaction is active. This was due to an expo-sqlite limitation where a nested transaction inside reassignRelationships conflicted with the parent bulk merge transaction. Stripped out the nested wrapper so the merge executes smoothly within a single atomic commit.
🪲 Fixed: Website APK Download Timeout (504 Gateway Error)
Users downloading the 92MB APK from the website frequently experienced a failed download. Vercel serverless functions have a 10s execution limit, causing the stream to forcibly timeout. Refactored the /api/download route to track analytics via Redis and immediately HTTP 302 redirect directly to the GitHub CDN, allowing full high-speed downloads directly from S3.
✨ New: Premium Design System v4.2.0
A complete visual overhaul based on WCAG AA accessibility standards and 2025 mobile design trends:
🎨 Color System & UI
- Richer background: Deep navy eliminates harsh halation
- WCAG AA compliant text: All text colors verified to 4.5:1+ contrast ratio
- 3-Layer Aurora Background: Three breathing radial gradients (violet, teal, indigo) that slowly drift.
- Glass Cards 2.0: Cards now have proper box shadow depth and subtle border edges.
- Tab Bar Overhaul: Solid opaque background, proper elevation shadow, active tint.
- Automatic First Sync: On first launch with contacts permission, the app automatically begins syncing.
📥 Getting Started
Download the APK below, or clone the repository to run locally on Expo Go.
📦 Asset Details
- File:
ContactForge-v4.2.0.apk - Size: ~92 MB
- SHA-256:
ACEE059F4EBF2D055BADB3B6D3C76B944E7FD123B2BD81F6C61A4C2A093FBB8B
Architected with 🖤 by Shivansh Mishra
Building privacy-first mobile systems with modern local-first architecture.
ContactForge v3.3.0 — The Performance & Integrity Update
🚀 ContactForge v3.3.0: The Performance & Integrity Update
We are thrilled to announce ContactForge v3.3.0 — a massive architectural leap forward for our offline-first, zero-cloud contact CRM.
This release focuses entirely on scaling the application for power-networkers and fortifying the data integrity of the local engine. We've ripped out the bottlenecks, upgraded the search engine, and made synchronization virtually bulletproof.
🔥 What's New?
⚡ SQLite FTS5 Indexed Search
Say goodbye to UI stutter on large contact lists. We've replaced the old JS-filtered search with a C-level SQLite Virtual Table (FTS5) implementation. Searches across 10,000+ contacts are now instantaneously resolved at the database layer.
🛡️ Zero-Loss Tombstone Sync Architecture
Data synchronization just got a major integrity upgrade. Deleting a contact now safely tombstones the record (is_deleted=1). This guarantees that deletions and merges propagate perfectly across your synced devices without resurrecting old data. Repeated syncs are now strictly idempotent—zero duplicate bleeding.
🧹 Bulk Action Multi-Select
You asked, we delivered. Long-press on the Dashboard to activate the new Multi-Select Mode. You can now mass-delete or export dozens of contacts to a VCF payload with a single tap.
🤝 Safe Merge Memory
Resolving duplicates is now permanent. The new Ignore Duplicate button in the Merge Preview UI saves your decision to the database, ensuring that dismissed pairs never clutter your command center again. Oh, and every merge still captures a pre-mutation snapshot to our global Undo Engine.
📱 One-Tap CRM Actions
The Contact Detail screen is no longer just a viewer—it's a launchpad. We've wired up native OS deep-links so you can instantly launch a WhatsApp thread, dial a number, or compose an email directly from the contact profile.
🛠️ Under the Hood (Performance Wins)
- Eliminated N+1 Queries: Re-engineered the list rendering pathways to fetch relationship and tag data cleanly without cascading DB roundtrips.
- Virtualized List Optimization: Stripped out hardcoded constraints and improved batch rendering, ensuring buttery-smooth scrolling on huge datasets.
📥 Getting Started
Download the latest signed APK from the assets below, or clone the repository to run it locally on Expo. No servers. No cloud. Just your data, moving at lightspeed.
Architected with 🖤 by Shivansh Mishra
Building privacy-first mobile systems with modern local-first architecture.
ContactForge v3.0.0 Beta 1 - The Power Cleanup Preview
ContactForge v3.0.0 — The Power Cleanup Update 🚀
Welcome to ContactForge v3.0.0, the most powerful, privacy-first offline contact organization utility. This release elevates the application into a SaaS-grade power-user product, built entirely around on-device data sovereignty and safety.
💎 What's New in v3.0.0
🧹 1. Power Cleanup Command Center
An interactive diagnostic and optimization center for your contact library:
- Diagnostics Headers: View real-time data health scoring and cleanup progress indicators.
- Categorized Quality Filters: Instantly isolate entries by Duplicates, Formatting, Incomplete, and Temporary.
- Multi-Select Workflows: Check off items and slide up the bottom actions toolbar to execute batch fixes or safe purges.
- Safe Preview Modal: Frosted transactional confirmation screen assuring full Undo Engine coverage.
⏪ 2. Resilient Undo Engine
- Completely covers all bulk and destructive operations.
- Captures granular database snapshots prior to any deletion or merge, saving state into the local SQLite store.
- Allows seamless one-tap recovery via a global bottom mounting snackbar.
👯 3. Smart Merge Conflict Resolution
- Sidestep data loss during deduplication merges.
- View beautiful side-by-side field diffs of matching candidates.
- Interactively resolve conflicts by selecting surviving field values or applying custom overrides.
📥 4. High-Fidelity Import Studio
- Offline visual CSV and VCF ingestion.
- Map columns dynamically and validate formats inline.
- Automatic truncation and padding safeguards protect large import lists from pollution.
🏛️ Technical Stack Upgrades
- Web Support: Enhanced
metro.config.jsto resolve WebAssembly.wasmmodules and serveSharedArrayBufferheaders. - Type Safety: Strictly validated codebase achieving zero TypeScript errors and zero ESLint warnings.
- Stability: Comprehensive Jest coverage with 115 passing tests across parsing, deduplication, normalizations, and database layers.
Architected with 🖤 by Shivansh Mishra. Privacy-first, local-first.