Authentication service for the Hourglass application with Google OAuth integration and intelligent image processing.

• 🔐 Google OAuth 2.0 authentication
• 🖼️ Automatic image processing with Cloudinary
• 🎨 Fallback avatar generation with user initials
• 📱 Responsive profile picture handling
• 🔒 Secure session management

• Automatically uploads Google profile pictures to Cloudinary
• Optimizes images (200x200px, auto quality)
• Organized in folders for better management

• Generates beautiful initial-based avatars when no profile picture exists
• Uses Canvas to create circular avatars with user's first initial
• Consistent color scheme based on user's name
• Uploads generated avatars to Cloudinary

• Multiple fallback levels ensure users always have a profile picture
• Graceful degradation to external avatar service if all else fails

1. Clone the repository

git clone <repository-url>
cd hourglass-auth

2. Install dependencies

npm install

3. Configure environment variables Copy .env.example to .env and fill in your credentials:

cp .env.example .env

Required environment variables:

• GOOGLE_CLIENT_ID - Google OAuth client ID
• GOOGLE_CLIENT_SECRET - Google OAuth client secret
• GOOGLE_CALLBACK_URL - OAuth callback URL
• CLOUDINARY_CLOUD_NAME - Cloudinary cloud name
• CLOUDINARY_API_KEY - Cloudinary API key
• CLOUDINARY_API_SECRET - Cloudinary API secret
• DATABASE_URL - PostgreSQL database URL
• SESSION_SECRET - Session encryption secret

4. Run the application

npm run dev

• GET /auth/google - Initiate Google OAuth
• GET /auth/google/callback - OAuth callback
• GET /auth/logout - Logout user
• GET /api/user - Get current user info
• GET /health - Health check

src/
├── app.js              # Express app configuration
├── index.js            # Application entry point
├── passport.js         # Passport OAuth configuration
├── controllers/        # Route controllers
├── database/          # Database configuration
├── routes/            # API routes
└── utils/             # Utility functions
    ├── imageHandler.js    # Image processing utilities
    └── testImageProcessing.js # Testing utilities

1. User Authentication: When a user logs in with Google
2. Image Check: System checks if user has a Google profile picture
3. Upload to Cloudinary: If image exists, uploads to Cloudinary with optimization
4. Generate Fallback: If no image, generates a beautiful initial-based avatar
5. Store URL: Saves the final image URL to the database
6. Error Handling: Falls back to external service if Cloudinary fails

For development mode with auto-reload:

npm run dev

For production:

npm start

ISC