Skip to main content

TecMeli Documentation

Build a robust Android client for Mercado Libre with Clean Architecture, Jetpack Compose, and modern Android development practices.

Get StartedExplore Architecture
// Clean Architecture
classGetProductsUseCase
suspend fun invoke()
→ Result<List<Product>>

Get Started in Minutes

Follow these steps to set up your TecMeli development environment

1

Clone the Repository

Clone the TecMeli repository to your local machine.
git clone https://github.com/bsvillarraga/TecMeli.git
cd TecMeli
2

Configure Credentials

Add your Mercado Libre API credentials to local.properties:
MELI_CLIENT_ID=your_client_id
MELI_CLIENT_SECRET=your_client_secret
MELI_REFRESH_TOKEN=your_refresh_token
You can obtain these credentials from the Mercado Libre Developer Portal.
3

Build and Run

Sync your project with Gradle and run the application:
./gradlew build
./gradlew installDebug
You can also use Android Studio to build and run the app on an emulator or physical device.

Explore by Topic

Learn about the architecture, features, and development practices

Architecture

Understand the Clean Architecture and MVVM patterns used throughout the app.

Authentication

Learn how OAuth 2.0 authentication and token refresh work seamlessly.

Network Layer

Explore the robust network layer with Retrofit, OkHttp, and error handling.

State Management

Discover how StateFlow and UiState manage reactive UI updates.

UI Components

Build modern UIs with Jetpack Compose and Material 3 design.

Testing

Write comprehensive unit and integration tests with MockK and Coroutines.

API Reference

Complete reference documentation for all layers of the architecture

Domain Layer

Models, repositories, and use cases that define business logic.

Explore

Data Layer

Repository implementations, remote APIs, and data mappers.

Explore

Core

Network infrastructure, DI modules, and shared utilities.

Explore

Ready to Build?

Start exploring the documentation and learn how to build a production-ready Android app with modern architecture.

Get Started Now

Build docs developers (and LLMs) love

Get started for freeTalk to us