SECURITY & ARCHITECTURE

Security at ClearKun

ClearKun is built on a local-first philosophy. Storage analysis occurs entirely on your Windows PC, isolating your personal documents, media, and filesystem from external servers.

01

Security Overview

Our core engineering principles prioritize local isolation, minimal cloud footprints, and human-in-the-loop control.

Traditional storage and disk cleaning tools often require broad system access, send telemetry payloads over the network, or perform destructive file deletions with one-click automation. ClearKun was engineered with an entirely different architecture:

Local Only

Local-First Execution

All file tree traversal, disk usage calculations, and space visualizations execute entirely on your Windows machine via native Win32 APIs.
Metadata Only

Zero File Ingestion

ClearKun only accesses file metadata (names, sizes, paths, timestamps). We never open, parse, or transmit document, photo, video, or code contents.
Safe Flow

User Confirmation

No file is ever deleted automatically in the background. Every deletion requires explicit user selection and interactive confirmation.
02

Security Architecture & Execution Boundary

A strict boundary separates local Windows storage analysis from minimal cloud APIs.

ClearKun Execution & Data Boundary

Filesystem analysis is performed locally on your Windows device. Only minimal required account and license metadata communicates with secure cloud APIs.

Local-First Architecture
Your Windows Device

Local Storage Engine

Stays on device
Native Win32 Metadata Scan

Inspects filenames, sizes, extensions, timestamps via optimized OS APIs. Zero document/photo/video content ingestion.

Local SQLite Analysis Database

Saved at %LOCALAPPDATA%\ClearKun\. Never uploaded or shared.

5-Tier Safety Classification & Action

User reviews and explicitly confirms all cleanup operations. Zero unprompted background deletions.

Cloud Boundary

Essential Cloud Services

Minimal
Clerk Authentication

Handles user sign-in, Google OAuth, and secure token issuance. ClearKun never receives passwords.

Supabase Database

Stores user profiles, early access registration, and license tier states.

Filesystem data never crosses into the cloud boundary.
03

Local Processing Guarantee

Storage scanning runs natively on your machine without cloud streaming.

When you initiate a scan in ClearKun, the desktop client invokes native Windows filesystem APIs (FindFirstFileExW, GetFileInformationByHandleEx) to query file records directly from the NTFS / FAT32 volume manager.

Zero Cloud File Streaming

PROVED ARCHITECTURE
Your folder hierarchy, disk contents, and scan results are never streamed to any remote server. Analysis indexes are written directly to a local, isolated SQLite database in your Windows user profile.
04

Data Boundaries

Explicit enumeration of what ClearKun accesses versus what remains strictly untouched.

ClearKun May Access (Local Metadata)
  • •File Paths & Names: To display storage locations (e.g. AppData\Local\Temp).
  • •File Sizes & Disk Allocation: To calculate space savings and large file rankings.
  • •File Extensions & Types: To categorize archives (.zip), media (.mp4), or caches.
  • •Timestamps: Creation, modification, and last accessed dates for safety tier classification.
ClearKun Does NOT Access (Strict Exclusion)
  • •File Contents: We never read inside your PDF, Word documents, text files, or source code.
  • •Photos & Videos: No pixel parsing, EXIF scraping, or visual processing.
  • •Browser History & Credentials: We never read browser passwords, cookies, or history databases.
  • •Keystrokes & Screen Data: Zero background recording, keylogging, or screen capture.
05

Authentication Security

Account identity is managed exclusively by Clerk with standard OAuth protocols.

ClearKun does not store user passwords. User authentication and session issuance are managed by Clerk.

OAuth 2.0

Google OAuth 2.0

Users can authenticate securely through Google Sign-In. ClearKun receives an authenticated session token and verified email address from Clerk.
Supabase

Backend Data Layer

Supabase is used as the backend data and edge function layer for access key resolution and user metadata. Supabase is not the authentication provider.
06

Network Security & Encryption

All communication with web endpoints is strictly encrypted in transit.

Whenever the desktop application or website communicates with our infrastructure (for license verification or account management), all network requests are encrypted using modern Transport Layer Security (HTTPS / TLS).

Clerk Authentication Endpointshttps://clerk.clearkun.in/v1/*
TLS Encrypted
Supabase Database APIhttps://*.supabase.co/rest/v1/*
TLS Encrypted
07

Local Application Data & Paths

Exact locations where ClearKun stores local configuration and scan databases.

ClearKun stores application state in standard, user-isolated Windows application folders. You retain full access to inspect or delete these directories at any time:

Application Root Directory:%LOCALAPPDATA%\ClearKun\
Local SQLite Analysis Index:%LOCALAPPDATA%\ClearKun\storage_index.db
Local Application Config:%LOCALAPPDATA%\ClearKun\config.json
08

File Deletion Safety & Human Confirmation

Understanding our 5-tier safety matrix and interactive confirmation safeguards.

User Review and Confirmation Policy

CRITICAL SAFEGUARD
ClearKun acts as a storage intelligence tool. It classifies discovered files into safety categories (e.g. Safe Cache, Developer Artifact, Caution, Review Required). However, the user retains ultimate control and responsibility for reviewing candidate files and confirming deletion.

ClearKun 5-Step Deletion Flow

  1. 01Local ScanTraverse file metadata
  2. 02ClassificationAssign safety tier
  3. 03User ReviewInspect items in UI
  4. 04ConfirmationUser confirms action
  5. 05Safe RemovalSend to Recycle Bin / Purge
09

Vulnerability Disclosure & Security Contact

Responsible disclosure procedures for security researchers and users.

If you discover a potential vulnerability or security issue within the ClearKun desktop client or website, we encourage responsible disclosure. Please reach out directly to our engineering team:

Security Inquiries & Reports[email protected] • Jaipur, Rajasthan, India
Submit Security Report
Available Now on Microsoft Store

Reclaim Your Windows Storage Today

ClearKun helps you understand your Windows storage, discover large and unnecessary files, and clean with confidence.

Free Download
100% Offline & Private
Works on Windows 10 & 11