> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/juuaaann456/DMI-Practica06/llms.txt
> Use this file to discover all available pages before exploring further.

# Cinemapedia

> A Flutter mobile app for browsing movies from TheMovieDB — explore what's playing now, upcoming releases, top-rated films, and more.

Cinemapedia is a Flutter mobile application that connects to [TheMovieDB API](https://www.themoviedb.org/) to let you browse movies across multiple curated categories. Built with clean architecture principles, it uses Riverpod for state management and GoRouter for navigation.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/getting-started/prerequisites">
    Get up and running with Cinemapedia in minutes
  </Card>

  <Card title="Architecture" icon="layer-group" href="/architecture/overview">
    Understand the clean architecture structure
  </Card>

  <Card title="Features" icon="film" href="/features/home-screen">
    Explore the movie browsing features
  </Card>

  <Card title="Reference" icon="code" href="/reference/widgets/movie-slideshow">
    Browse widgets, providers, and data models
  </Card>
</CardGroup>

## What Cinemapedia offers

<CardGroup cols={2}>
  <Card title="Now Playing" icon="clapperboard">
    See movies currently showing in theaters, updated in real time from TheMovieDB
  </Card>

  <Card title="Upcoming Releases" icon="calendar">
    Browse films arriving soon so you never miss a premiere
  </Card>

  <Card title="Popular & Top Rated" icon="star">
    Discover popular picks and all-time favorites ranked by audience votes
  </Card>

  <Card title="Mexican Cinema" icon="flag">
    A dedicated category showcasing Mexican films sorted by rating
  </Card>
</CardGroup>

## Getting started

<Steps>
  <Step title="Get a TheMovieDB API key">
    Sign up at [themoviedb.org](https://www.themoviedb.org/) and generate a free API key from your account settings.
  </Step>

  <Step title="Install Flutter">
    Make sure Flutter SDK 3.9.2 or later is installed. See the [prerequisites page](/getting-started/prerequisites) for details.
  </Step>

  <Step title="Clone and configure">
    Clone the repository and add your API key to the `.env` file. See the [installation guide](/getting-started/installation) for the full setup.
  </Step>

  <Step title="Run the app">
    Run `flutter run` and Cinemapedia will launch with live movie data from TheMovieDB.
  </Step>
</Steps>