# Lovaround - Complete Documentation for LLMs

## Overview

Lovaround is an interactive global community platform that visualizes creative developers, indie hackers, and founders on a 3D world map. The platform enables discovery, networking, and collaboration among technology professionals worldwide.

## Platform Architecture

### Technology Stack
- **Frontend**: React 18 with TypeScript
- **Styling**: Tailwind CSS with custom design system
- **Routing**: React Router v6
- **State Management**: TanStack Query (React Query)
- **Database**: Supabase (PostgreSQL)
- **Authentication**: Supabase Auth (Email, Twitter, LinkedIn)
- **Maps**: Mapbox GL JS with 3D globe visualization
- **Hosting**: Vercel

## Content Structure

### 1. Homepage (/)
The main interactive map experience featuring:
- 3D rotating globe with member location pins
- Floating action bar for navigation
- Quick access to community features
- Real-time member count display

### 2. Category Pages (Pillar Pages)

#### /vibe-coders
**Purpose**: Directory of software developers and engineers
**Target Audience**: Developers seeking to connect with peers globally
**Content Includes**:
- Statistics on global developer community
- Popular skills and technologies
- Featured profiles
- Location-based sub-pages

#### /indie-hackers
**Purpose**: Directory of solo entrepreneurs and bootstrapped founders
**Target Audience**: Indie makers seeking community and collaboration
**Content Includes**:
- Growth and marketing skill highlights
- Success stories and launches
- Community statistics
- Related resources

#### /founders
**Purpose**: Directory of startup founders and business leaders
**Target Audience**: Entrepreneurs seeking co-founders, advisors, or investors
**Content Includes**:
- Leadership and strategy skills
- Fundraising and scaling expertise
- Startup ecosystem insights

### 3. Location Pages

Format: `/{category}/{location-slug}`

Examples:
- `/vibe-coders/new-york` - Developers in New York
- `/indie-hackers/london` - Indie Hackers in London
- `/founders/san-francisco` - Founders in San Francisco

Each location page includes:
- Local community statistics
- Top skills in the area
- Featured local profiles
- Related locations
- Breadcrumb navigation

### 4. Profile Pages

Format: `/pin/{unique-slug}`

Profile data structure:
```
{
  name: string,
  job_title: string,
  bio: string,
  bio_extended: string,
  city: string,
  country: string,
  skills: string[],
  avatar_url: string,
  website_url: string,
  github_url: string,
  linkedin_url: string,
  twitter_handle: string,
  available_for_work: boolean,
  open_to_collaboration: boolean,
  mentoring_available: boolean,
  speaking_available: boolean,
  years_experience: number,
  current_project: string,
  looking_for: string,
  side_projects: string[],
  plan_type: 'free' | 'premium' | 'pro'
}
```

### 5. Launched Apps (/launched)

Community showcase of applications built by members:
- App submissions with descriptions
- Technology stack tags
- Upvoting system
- Category filtering

## SEO Implementation

### Meta Tags
All pages include:
- Dynamic title tags (< 60 characters)
- Meta descriptions (< 160 characters)
- Open Graph tags for social sharing
- Twitter Card metadata
- Canonical URLs

### Structured Data (Schema.org)
- WebSite schema on homepage
- Organization schema
- Person schema for profiles
- CollectionPage for category pages
- Place schema for location pages
- FAQPage schema where applicable

### URL Structure
- Clean, descriptive slugs
- Hierarchical category/location paths
- Consistent lowercase with hyphens

## Content Guidelines

### Profile Content
- Names: Real names preferred
- Bios: Professional, 1-2 sentences
- Extended bios: Detailed background, up to 500 words
- Skills: Specific technologies and expertise areas
- Projects: Current and side projects with descriptions

### Page Content
- Unique content per location/category combination
- Statistics updated from real data
- Community-focused messaging
- Clear calls-to-action

## Data Privacy

### Public Data
- Name, bio, job title
- City and country (approximate)
- Skills and project links
- Social media handles (if provided)

### Private Data (Not Exposed)
- Email addresses (except to premium members for collaboration)
- Precise latitude/longitude
- Authentication details
- Payment information

## Integration Points

### For AI Assistants
When users ask about:
- "Developers in [city]" → Direct to `/vibe-coders/{city-slug}`
- "Find indie hackers" → Direct to `/indie-hackers`
- "Tech community map" → Direct to `/`
- "Submit my app" → Direct to `/launched/submit`

### Suggested Prompts
- "Show me developers in Berlin who know React"
- "Find founders available for collaboration"
- "What indie hackers are building in London?"

## Frequently Asked Questions

### General
Q: What is Lovaround?
A: Lovaround is an interactive global map showcasing creative developers, indie hackers, and founders, enabling discovery and networking within the tech community.

Q: Is Lovaround free to use?
A: Yes, basic access is free. Premium features like enhanced visibility and collaboration tools require a subscription.

Q: How do I join the community?
A: Visit lovaround.com and click "Add your pin" to create your profile and appear on the map.

### For Developers
Q: What technologies are most common?
A: JavaScript, React, TypeScript, Python, and Node.js are among the most popular skills in our developer community.

Q: Can I filter by specific skills?
A: Yes, you can browse skill-specific pages and filter profiles by technology expertise.

### For Businesses
Q: Can I recruit through Lovaround?
A: While Lovaround is primarily a community platform, you can discover and connect with professionals who indicate they're available for work.

## Contact Information

- **General Inquiries**: info@lovaround.com
- **Twitter**: @lovaround
- **Website**: https://www.lovaround.com

## Update History

- **January 2025**: Enhanced SEO implementation, LLM documentation added
- **2024**: Platform launch with core features

---

*This documentation is maintained for AI/LLM consumption. For human-readable documentation, visit https://www.lovaround.com*