WaSecure — Complete Feature Guide

Login & Registration

• Email + password registration
• Email + password login
• Session-based auth (cookie)

WhatsApp Pairing

• Phone number entry (international format)
• 8-digit pairing code displayed (enter on phone: Settings > Linked Devices > Link with phone number)
• Auto-reconnects on page reload if session is valid
• Auth state persisted server-side (survives restarts)

Connection Status (visible in Icon Rail)

Hover shows phone number and state text.

56px vertical bar on the left edge of the screen.

Section 1: User & Panel Toggles

Section 2: Main Navigation

Section 3: Bottom Tools

Section 4: Status

View Tabs

Search

• Simple search — filters by name, phone number, or WhatsApp ID (real-time, local)
• Advanced search — Ctrl+Shift+F — searches across all message content
• Escape clears search text

Label Filter

• Toggle checkbox enables label filtering
• Multi-select dropdown with color indicators
• Shows label name + chat count
• OR logic (matches any selected label)
• "Clear all" button

Sort Order (automatic, not configurable)

1. Pinned contacts first (oldest pin to newest)
2. Then by last message timestamp (newest first)

Contact Row (each 72px tall)

Context Menu (right-click or chevron)

1. Archive / Unarchive
2. Mute / Unmute
3. Pin / Unpin
4. Mark as read / Mark as unread
5. Labels (submenu with checkmarks)
6. Block / Unblock (1:1 chats only)
7. Clear chat
8. Exit group (groups only)
9. Delete

Zoom Controls

Plus/minus buttons with percentage display. Persisted across sessions.

Message Types Supported

Special Message Labels

• Imported — amber badge with archive icon
• AI — blue badge with bot icon
• Forwarded — italic text, "Forwarded" or "Forwarded many times"

Message Actions (hover chevron menu)

Delivery Status (own messages)

Other Indicators

• Edited — "Edited" label on modified messages
• Starred — Yellow star icon
• Reactions — Emoji pills below message with counts

Date Separators

"Today", "Yesterday", or full date ("Monday, 15th January 2025"). Inserted when date changes.

Scroll & Navigation

• Scroll position memory — restores per chat across navigation
• "Go to latest" button — floating button when scrolled >150px up
• "Load earlier messages" — button at top for older history
• "Load newer messages" — button at bottom in date-browsing mode
• Jump to date — calendar picker + quick buttons: 1 wk, 1 mo, 3 mo, Start

Group Chat Features

• Colored sender names — 8 colors (salmon, gold, green, cyan, pink, purple, orange, teal) assigned by hash
• Consecutive collapsing — reduced spacing when same sender sends multiple messages

Translation

• Per-message toggle — switch between original and translated text
• Auto-translate incoming — shows translated version by default (configurable per contact)
• Manual translate — click button on specific message, stored in DB

Header Controls

Reminder Banner

Yellow/amber bar at top when a reminder is due. Shows reminder text + how long ago created. "DONE" button to mark complete.

Selection Mode (via Maintenance)

• Checkbox per message, amber highlight
• Bulk delete selected messages
• Selection count in modal header

Toolbar Row (above text input)

Quick Phrases Panel

• Shows all saved CRM phrases + WhatsApp quick replies
• Click to paste into composer
• Hover actions: move up/down, edit (inline), delete

Setup Wizards (triggered automatically)

Attachment Menu (+ button)

Slash Commands

• Type / at start of message to trigger autocomplete
• Matches CRM phrases and WhatsApp quick replies
• Keyboard: Arrow Up/Down navigate, Enter/Tab select, Escape close
• Live sync via SSE when WA quick replies change

Text Input

• Auto-resizes with content (1 line up to ~10 lines / 240px)
• Spellcheck enabled
• Enter = send message
• Shift+Enter = new line
• Escape = close slash autocomplete
• Resets to 1 line after sending

Reply-to Display

Green-bordered quote card above textarea. Shows "You" or sender name + quoted message text. Cancel button (X) to dismiss. Auto-focuses textarea when reply initiated.

Typing Indicators

Sends "composing" signal on first keystroke, "paused" after 3 seconds of silence.

Hero Section (persists across all tabs)

Tab: Main

Scam Warning Banner

• Tiers: none, small (<$10), medium ($10-20), large ($20-100), major ($100+)
• Display: Confidence %, factual summary, colored by severity
• Actions: File report, Retract report, Dismiss auto-warning, Block contact

Red Flag Alert (banner on all tabs when level ≥ 2)

• Levels: 0 (none) to 3 (high concern)
• Categories: Money Requests, Location Probing, Pet Names, Guilt Manipulation, Secrecy, Video Evasion, Occupation Claims, Financial, Isolation, Premature Intimacy, Investment, Promise Deferral, Financial Test
• Actions: Full Scan, Report, Dismiss/Undismiss, Share (clipboard)

Contact Cycle

Input: "Contact every N days" (1-365). Auto-saves.

Reciprocity Tracking

• Period selector: 30d, 90d, All
• Who starts: You vs Them ratio bar + session count
• Response: Your/their response rate (%) + average response time
• Volume balance: Messages ratio + Words ratio (your vs them), media counts
• Engagement: Your/their question ratio (%), average message length

Behavioural Analysis

• Composite Warning Score: 0-100% gauge (green/yellow/orange/red), signal list
• Timing Heatmap: 7 days x 24 hours grid, estimated timezone, peak day/hour
• Endearments: From them / From you counts + density %, top 5 terms with category

Notes

• Freeform textarea (auto-save after 500ms)
• Summarise button: AI-generated conversation summary
• Summary actions: Append to notes, Replace notes, Refresh, Dismiss

Media Preview

8-thumbnail grid (4 columns). "+N more" indicator. Click to open Media Browser.

Tab: Flags

Fact Checker (Contradiction Detection)

• Analyze button — scans conversation for facts and contradictions (costs credits)
• Full refresh — re-analyze all messages
• Credit cost estimate shown before running
• Contradictions: Red box with confidence % (color-coded), "Earlier" vs "Later" fact comparison
• Extracted Facts: Collapsible cards with category badges (age, location, job, family, finances, education, relationship, other)

Tab: Info

Tab: AI

Action Types

Action Card Buttons

• Chat — opens conversation
• Where Were We — AI summary of last conversation (overdue/due soon only)
• Snooze — dropdown: 1d, 3d, 7d, 14d, 30d
• Dismiss — removes until next cycle

Create Trip

• Name input
• Destination search (geocoding with debounce) + Map pin-drop
• City/Country (auto-filled or manual)
• Contact search radius slider (10-500 km)
• Start date / End date pickers

Trip Cards

Trip name + status badge (Planned/Confirmed/Traveling/Completed/Cancelled). Location, dates, days until (if within 30d), contact count.

Trip Detail View

• Status dropdown, destination, dates, budget, radius, notes
• Map with trip marker + radius circle
• Manual contacts (added by user, delete on hover)
• "Find people nearby" button: searchable list of contacts within radius showing name, city, distance (km), "Add" button

Area Manager

• Create Area: Name, search/pin-drop location, city/country, radius slider
• Area Cards: Name, coordinates, radius, contact count, Edit/Delete, expand to see contacts

Personality Cards

Large emoji + name. Yellow star for default. Edit, Delete, Star buttons. System prompt preview (3 lines).

Create / Edit Modal

Emoji input (max 4 chars), name input, system prompt textarea (large), save button.

Assignments Table

• 12-chapter interactive HTML guide ("The Expat's Guide to Staying Safe")
• Covers scam pattern recognition and WaSecure alert explanations
• Accessible from Icon Rail (BookOpen) and onboarding

Export

• Tier selector (Base/Plus controls feature set)
• Date range picker
• Contact multi-select
• Media subsample toggle
• Export history log
• Download as .zip

Import

• Drag-and-drop .zip or .txt files
• WhatsApp chat import (Android/iOS .txt format)
• WaSecure round-trip import (re-import previously exported data)
• MD5 fingerprinting for dedup

General

Profile

Media

Storage usage display and cleanup options.

Contacts

Import/export contact list.

CRM

Labels

• Label list: color square, name, "built-in" badge, chat count
• Edit: name + 10 color options
• Add new label: name + color
• Delete (non-predefined only)
• Reminder rules per label: toggle + days before reminder

Data

Export/Import panel (same as Import & Export page).

Billing

Subscription status, storage meter (used/quota with warning levels), plan selector (Base $9.95/mo, Plus $14.95/mo).

Provider

Translate

Rewrite

Log

Auto-reply history: contact phone, personality emoji + name, tokens, response time, incoming preview (80 chars), AI response preview (120 chars), timestamp. Refresh button.

DeepL Setup Wizard (triggered when translate clicked with no key)

AI Setup Wizard (triggered when any AI feature used with no key)

Credits Exhaustion Flow (triggered when credits run out)

Admin-only. 30-second auto-refresh on most tabs.

Overview Tab

Users Tab

Connections Tab

Telemetry Tab

Range selector: 1h, 6h, 24h, 7d. Capacity estimates: Peak RAM, Peak RSS, Avg CPU, RAM headroom.

Events Tab

Filterable audit log: event type dropdown, user search, date range (1h/6h/24h/7d). Paginated 50 per page.

Scam Reports Tab

Feedback Tab

Summary bar (5 severity cards). Filters: severity buttons + area dropdown. Table with screenshot lightbox. Delete entries.

User Detail Modal

Info grid: Email, phone, subscription, WA state, SSE clients, schema, last login, socket age, reconnects/hr.

Data counts: Contacts, chats, messages. Message stats (24h): Sent, received.

Sessions: Token IDs, expiry, Revoke per session, "Revoke All".

Recent events: 20 entries, scrollable.

Connections Dialog (5 actions, each with inline confirm)

Destroy Dialog (4 checkboxes, cascading)

Must type "YES" to enable execute button.