# Introduction

**Tea Framework** is a progressive *modding framework* and *library* for [tModLoader](https://github.com/tModLoader/tModLoader).

{% hint style="warning" %}
Tea Framework is still a work-in-progress, expect the documentation to evolve over time.

Once a release comes out, no breaking changes will be made. If required, we will only mark members as obsolete.
{% endhint %}

### Installation

To learn how to install and use Tea Framework in your mod, see [here](https://tomat.gitbook.io/tea-framework/installation).

{% hint style="danger" %}
Tea Framework is a **commitment**. We not only expect you to have a solid grasp on C# and tModLoader, but also expect that you want to stay with Tea Framework. Tea Framework abstracts various components of tModLoader, so moving away from it may prove time-consuming.
{% endhint %}

### Understanding Service Providers and Singleton Lifetimes

Tea Framework's entire API is founded around the idea of a service provider that belongs to a `Terraria.ModLoader.Mod` instance. View the rundown [here](https://tomat.gitbook.io/tea-framework/features/service-providers).

### Understanding the Reworked Load Cycle

Tea Framework overhauls how mod loading works for your mods, view the details [here](https://tomat.gitbook.io/tea-framework/features/load-steps).

### Features

~~For a general feature rundown, please view the~~ [~~README~~](https://github.com/rejuvena/tea-framework#readme) ~~over at~~ [~~rejuvena/tea-framework~~](https://github.com/rejuvena/tea-framework)~~.~~ Feature documentation is a work-in-progress.

### Utilities

Utility documentation is a work-in-progress.
