Authentication Documentation

Overview

This directory contains all authentication-related documentation for the do.dev application. The project uses Clerk for modern authentication with role-based access control.

🎯 Quick Start for do.dev Authentication

New to Clerk Authentication?

• CLERK_ENV_VARIABLES.md - Complete environment variables reference
• AUTH_ENVIRONMENT_SETUP.md - Detailed environment setup
• EMAIL_SETUP.md - Email authentication setup

🔐 Core Authentication System

Current Architecture

• CLERK_AUTHENTICATION_ARCHITECTURE.md - Complete Clerk integration architecture
• AUTHENTICATION_ARCHITECTURE.md - Overall authentication system design
• CONVEX_MULTI_PROJECT_ARCHITECTURE.md - Multi-deployment Convex setup

Implementation Guides

• CLERK_CONVEX_SYNC_DESIGN.md - User synchronization between Clerk and Convex
• APP_SPECIFIC_AUTH.md - Multi-tenant authentication for dodev
• AUTH_SERVICE_IMPLEMENTATION.md - Auth service implementation details

🚀 Setup & Configuration

Quick Start

1. CLERK_ENV_VARIABLES.md - Environment variables reference
2. AUTH_ENVIRONMENT_SETUP.md - Detailed environment setup
3. EMAIL_SETUP.md - Email authentication setup
4. GOOGLE_AUTH_SETUP.md - Google OAuth configuration

OAuth Providers

• GOOGLE_AUTH_SETUP.md - Complete Google OAuth guide
• GOOGLE_AUTH_QUICK_SETUP.md - Quick setup for Google OAuth
• AUTH_OAUTH_SETUP.md - General OAuth configuration

Testing

• AUTH_TESTING_GUIDE.md - Testing authentication flows
• PLAYWRIGHT_GOOGLE_AUTH_SETUP.md - E2E testing with OAuth

🛠️ Troubleshooting & Maintenance

Common Issues

• CLERK_URL_MASKING_STRATEGIES.md - Hiding Clerk parameters

Maintenance

• CLEAR_AUTH_DATA.md - Clearing authentication data

📋 Status

The authentication system migration to Clerk is complete. For historical migration documentation, see the archive.

🔗 Related Documentation

Architecture

• Multi-Project Convex Architecture
• RBAC Implementation

Development

• TypeScript Best Practices
• Roles Documentation

Quick Reference

Environment Variables

# Clerk Configuration
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_xxx
CLERK_SECRET_KEY=sk_test_xxx

# Main Convex Application
NEXT_PUBLIC_CONVEX_URL=https://standing-bird-371.convex.cloud

Key Concepts

• Clerk Authentication: Modern authentication with email OTP, Google OAuth, and GitHub OAuth
• User Sync: Clerk users synchronized to Convex main deployment
• Organization Support: Multi-tenant organization and team management
• RBAC: Role-based access control with waitlist, user, admin, and super_admin roles