# Wemme - Full Technical & Feature Specification

## Overview
Wemme (wem.me) is a "Link-as-a-Service" platform specifically optimized for the WhatsApp ecosystem. It solves the problem of long, untrustworthy-looking default WhatsApp links by providing clean, branded redirects and actionable business intelligence.

## Technical Architecture
- **Frontend**: Astro (Web Framework), Vanilla CSS (Custom Design System).
- **Authentication**: Clerk (Identity Management).
- **Backend/Edge**: Cloudflare Workers & D1 Database (Edge Computing).
- **Analytics Engine**: Real-time tracking of referrers, devices, and global locations using Cloudflare's edge data.
- **Design Language**: Dark-mode glassmorphism, focusing on premium SaaS aesthetics.

## Detailed Feature Set

### 1. WhatsApp Link Generator
- **Input**: Country Code + WhatsApp Number + Optional Message + Optional Suffix.
- **Validation**: Real-time phone number formatting validation.
- **Output**: Shortened `wem.me/[suffix]` link and a `wa.me` fallback.

### 2. Analytics Dashboard
- **Unique Visitors (UV)**: Uses edge-calculated finger-printing or session data to identify unique users.
- **Total Redirects (PV)**: Total number of clicks processed.
- **Top Source**: Identifies where traffic is coming from (Instagram, Facebook, Direct, etc.).
- **Top Market**: Geographic distribution of clicks (e.g., China, USA, Brazil).
- **Last Click**: Precise timestamp of the most recent interaction.
- **Device Stats**: Distribution of Mobile (iOS/Android) vs PC users.

### 3. QR Code Utility
- Uses high-quality canvas rendering to generate QR codes.
- Supports instant "Download as Image" for use in offline marketing materials like business cards or product packaging.

## FAQ
- **Is it free?**: Yes, Wemme provides core link generation and basic analytics for free.
- **Is it safe?**: Yes, we use standard WhatsApp redirection protocols. We do not store message content.
- **Do I need an account?**: You can generate links without an account, but you must sign in to view and manage your link performance analytics.

## Comparison to Competitors
Unlike generic URL shorteners (Bitly, TinyURL), Wemme is purpose-built for WhatsApp, offering:
1. Native country code selection.
2. Pre-filled message templates.
3. WhatsApp-specific UI components (mobile preview).
4. No registration required for basic generation.

## Future Roadmap
- Integration with major CRM platforms.
- A/B testing for different greeting messages.
- Advanced retargeting pixel support.