Skip to main content

Los Inmaduros Backend API

Professional REST API for the Los Inmaduros Rollers Madrid skating community. Manage routes, organize meetups, collect reviews, and share photos with complete authentication and security.

Get StartedAPI Reference
# Quick example
GET /api/routes
POST /api/route-calls
POST /api/photos
Complete API documentation →

Quick Start

Get up and running with the Los Inmaduros Backend API in minutes

1

Set up your environment

Clone the repository and configure your environment variables with Clerk and Supabase credentials.
git clone https://github.com/Adriasu09/los-inmaduros-backend.git
cd los-inmaduros-backend
cp .env.example .env
2

Start with Docker

Launch the complete stack including PostgreSQL database and backend server with hot reload.
npm run docker:dev
Docker automatically runs migrations, installs dependencies, and starts the server at http://localhost:4000
3

Explore the API

Access the interactive Swagger documentation to test endpoints and understand the API structure.
open http://localhost:4000/api-docs

Explore by Topic

Deep dive into specific features and capabilities

Authentication

Secure API access with Clerk authentication and JWT tokens

Routes Management

Access 17 predefined roller skating routes with difficulty levels

Route Calls

Organize and manage skating meetups with meeting points

Photo Gallery

Upload and manage photos with Supabase storage integration

Reviews & Ratings

Collect user feedback and calculate average ratings

Deployment

Deploy to production with Docker and environment configuration

Key Features

Everything you need for a production-ready skating community API

Clerk Authentication

Secure JWT-based authentication with role management

Rate Limiting

Protection against abuse with configurable rate limits

Pagination Support

All list endpoints support pagination with metadata

OpenAPI Documentation

Interactive Swagger UI with complete API specifications

Docker Ready

Complete Docker setup for development and production

Type Safety

Built with TypeScript and Zod for runtime validation

Ready to get started?

Follow our quickstart guide to have your API running locally in under 5 minutes with Docker

Start Building

Build docs developers (and LLMs) love

Get started for freeTalk to us