Tinder API

Purpose for technical assignment $520/month

🚀 Deployment

This application is ready to deploy on Render.com (free tier) with PostgreSQL database.

📚 Documentation

• DEPLOYMENT.md - Complete deployment guide for Render.com
• CHECKLIST.md - Step-by-step deployment checklist
• QUICKSTART.md - Local development setup and testing
• ALTERNATIVES.md - Other free deployment platforms (Railway, Fly.io, etc.)

One-Click Deploy to Render

1. Push this repository to GitHub
2. Go to Render Dashboard
3. Create a new Blueprint and select this repository
4. Render will automatically detect render.yaml and deploy everything!

Live Demo: Once deployed, your API will be available at https://your-app-name.onrender.com

API Documentation

This project uses Swagger/OpenAPI for comprehensive API documentation. The interactive API documentation is available at:

Swagger UI: http://localhost:8000/api/documentation

Features

• 🔐 Authentication: Complete documentation for register, login, and logout endpoints
• 🔒 Laravel Sanctum: Integrated bearer token authentication
• 📝 Interactive Testing: Try out API endpoints directly from the browser
• 📋 Auto-generated: Documentation is automatically generated from code annotations

Available Endpoints

Authentication

• POST /api/v1/register - Register a new user
• POST /api/v1/login - Login user
• POST /api/v1/logout - Logout user (requires authentication)

Generating Documentation

The Swagger documentation is automatically generated. To manually regenerate:

php artisan l5-swagger:generate

Development

In development mode, the documentation is automatically regenerated on each request. For production, set:

L5_SWAGGER_GENERATE_ALWAYS=false

Laravel Features

• Simple, fast routing engine.
• Powerful dependency injection container.
• Multiple back-ends for session and cache storage.
• Expressive, intuitive database ORM.
• Database agnostic schema migrations.
• Robust background job processing.
• Real-time event broadcasting.

Laravel is accessible, powerful, and provides tools required for large, robust applications.

Learning Laravel

Laravel has the most extensive and thorough documentation and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework. You can also check out Laravel Learn, where you will be guided through building a modern Laravel application.

If you don't feel like reading, Laracasts can help. Laracasts contains thousands of video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library.

Laravel Sponsors

We would like to extend our thanks to the following sponsors for funding Laravel development. If you are interested in becoming a sponsor, please visit the Laravel Partners program.

Premium Partners

• Vehikl
• Tighten Co.
• Kirschbaum Development Group
• 64 Robots
• Curotec
• DevSquad
• Redberry
• Active Logic

Contributing

Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the Laravel documentation.

Code of Conduct

In order to ensure that the Laravel community is welcoming to all, please review and abide by the Code of Conduct.

Security Vulnerabilities

If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via taylor@laravel.com. All security vulnerabilities will be promptly addressed.

License

The Laravel framework is open-sourced software licensed under the MIT license.