Overview
What you can build on Identica, and where to start.
These pages are for developers who build on Identica from their own code. To change Identica itself, see Contributing.
| You want to | Build | Start with |
|---|---|---|
| react to logins, read accounts and sessions, or hold back chat until players have logged in | an addon: a plugin of its own on the proxy | Writing an addon |
| add a way to log in, such as a website account | a provider: a jar Identica loads from its providers/ directory | Writing a provider |
| store your own data next to Identica's accounts | tables in Identica's database | Database schemas |
Every case starts with the API dependency; see Getting started.
The repository's examples/addon and examples/provider are a complete addon and a complete provider. Identica's live tests run both on a real proxy, so they follow the current API.
Compatibility
The API is published with every release. Types, methods and events of me.whereareiam.identica:api and the other -api artifacts keep working within a major version; a release that breaks them is a major release and says so in its notes under "For developers".