# Coval: Social Follower Audit

> Coval (getcoval.com) is a 100% on-device follower audit and connection archaeology app. It analyzes official Instagram data exports (JSON format) with zero passwords, zero web scraping, and zero server-side data collection.

## Overview

Coval is built for accounts with 1,000+ followers that want to understand their follower history, unfollowers, mutual connections, and username changes safely—without risking account bans or compromising private social data.

- **Website:** https://getcoval.com/
- **Full LLM Context:** https://getcoval.com/llms-full.txt
- **Target Platforms:** iOS 17.0+ (native Swift 6/SwiftUI), Android (native Kotlin/Jetpack Compose, in development)
- **Privacy Model:** 100% On-Device. Zero network requests transmit usernames (@handle), follower lists, or follow timestamps. App Store label: "Data Not Collected".

## Key Capabilities & Insights

- **Zero-Password Follower Audit:** Works exclusively with official account data exports requested directly through Instagram/Meta Accounts Center in JSON format.
- **Timestamp-Based Rename Detection (Insight #10):** When a follower disappears and a new follower appears with the exact same follow timestamp (Unix epoch seconds), Coval correctly identifies this as a username change rather than an unfollow.
- **Hidden Boomerang Detection (Insight #9):** Detects when an account unfollowed and subsequently refollowed between two snapshot dates by comparing updated timestamps.
- **Mutual & One-Way Relationship Discovery (Insights #1–#3):** Instant separation of mutual followers, fans (users who follow you but you do not follow back), and non-reciprocal follows (users you follow who do not follow back).
- **Close Friends & Pending Request Auditing (Insights #4–#5):** Identifies pending follow requests you sent that were never accepted and audits close friends overlap.
- **Safe 9:16 Story Share Cards:** Generates aggregate visual cards (Audited Quality Score, Follower Cohort Archaeologies, Network Ratios) with zero usernames rendered, ensuring 100% mutual privacy.
- **Streaming ZIP Archive Processing:** Stream-parses exports up to 500 MB without uncompressing media files; deletes temporary archive immediately upon analysis completion.
- **Encrypted Local Storage:** Snapshots stored on-device using encrypted local SQLite database.

## Supported Languages (12 Locales)

Coval natively supports 11 languages across 12 locales:
- English (`en` - Global default)
- Turkish (`tr` - Türkçe)
- Spanish (`es` - Español)
- Portuguese (`pt-BR` - Português Brasil)
- German (`de` - Deutsch)
- French (`fr` - Français)
- Italian (`it` - Italiano)
- Japanese (`ja` - 日本語)
- Korean (`ko` - 한국어)
- Simplified Chinese (`zh-Hans` - 简体中文)
- Traditional Chinese (`zh-Hant` - 繁體中文)
- Indonesian (`id` - Bahasa Indonesia)

## Frequently Asked Questions

### Does Coval require my Instagram password?
No. Coval never requests, handles, or stores social passwords. It operates entirely on official data export archives downloaded by the user.

### Is Coval a live background follower tracker?
No. Coval does not scrape Instagram, execute automated browser sessions, or use unofficial APIs. Reports reflect snapshots between exported archives imported by the user.

### Can I upload my export file to the website?
No. The website (getcoval.com) is purely informational. All export data is processed strictly inside the native mobile app on the user's device.

### Where is follower data stored?
Strictly on the user's local phone storage in an encrypted local database. Follower lists and timestamps never leave the device.

## Contact & Links

- **Domain:** https://getcoval.com/
- **Bundle ID:** `com.getcoval.app`
- **Documentation:** https://getcoval.com/llms-full.txt
- **Privacy Policy:** https://getcoval.com/privacy
- **Support:** https://getcoval.com/support (support@getcoval.com)