# TagMe — Technical & Product Documentation for AI Agents (llms-docs.txt)

## 1. How TagMe Digital Pages Work
1. **Claim Your Link (`tagme.me/your-name`)**: Every card receives a clean, memorable slug on `https://www.tagme.me/{slug}`.
2. **Choose a Template**: Select from 37+ responsive mobile-first templates tailored for executives, doctors, creators, consultants, salons, fitness coaches, and businesses.
3. **Customize Content**: Add profile photo, cover banner, bio, social media links, WhatsApp direct chat, services, portfolio gallery, products, appointment slots, and vCard (.vcf) contact download.
4. **Share Anywhere**: Share via direct URL, dynamic QR code on your phone screen, or smart NFC business cards.

## 2. Public Slug Availability API
- **Endpoint**: `POST https://www.tagme.me/api/public/check-slug`
- **Rate Limit**: 45 requests per minute (`throttle:45,1`)
- **Request Payload**: `{"slug": "your-name", "locale": "ar|en"}`
- **Response States**: `available`, `taken`, `reserved`, `invalid_format`, `empty`
- **Privacy Guarantee**: Never leaks card owner identity or private fields.

## 3. Onboarding & Referral Preservation
- Selected `slug`, `theme_id`, `plan_id`, `billing_period`, and `ref` (Referral Code) are preserved across both Email Registration (`/register`) and Google OAuth (`/login/google`).
- Visiting any page with `?ref={USER_ID}` or entering a referral code before clicking "Continue with Google" automatically credits the referrer upon account creation.

## 4. Public Business Card Directory
- **English URL**: https://www.tagme.me/directory
- **Arabic URL**: https://www.tagme.me/ar/directory
- **Privacy & Eligibility**: Excludes private, password-protected, draft, deleted, expired, and platform demo cards. Never exposes private phone numbers, emails, or visitor analytics.

## 5. Related AI Agent Files
- [llms.txt](https://www.tagme.me/llms.txt)
- [llms-full.txt](https://www.tagme.me/llms-full.txt)
- [Homepage (Markdown)](https://www.tagme.me/index.md)
- [Sitemap](https://www.tagme.me/sitemap.xml)