Skip to content
productdevbookPublic

About

Open-source customer messaging for teams with many products: e-mail, live chat and in-app conversations in one inbox. Pre-alpha.

Topics

Resources

Contributing

Security policy

Stars

8 stars

Watchers

0 watching

Forks

Repository files navigation

Yuva logo

Yuva

One inbox for every product you run.

Website · Docs · API · Releases · Roadmap

Release CI License: AGPL-3.0 SDKs: MIT

Yuva is an open-source support inbox. Support e-mail, live chat and in-app messages from all your products land in one shared inbox. You host it yourself: one Docker image and Postgres.

The Yuva panel: conversations from three products in one list, and an e-mail conversation open as a chat, with a teammate's note and a suggested reply.

Warning

Pre-alpha. The API and database schema can change without migration paths, and the code has not had an independent security audit. Try it with test data, not real customer conversations.

What you get

  • One inbox per product, each with its own branding, language, hours and team.
  • E-mail, live chat and in-app messages in one conversation: the <yuva-chat> web component, iOS and Android SDKs, and an API.
  • Your users stay yours. Your backend signs identity tokens; signed webhooks tell it what happened.
  • Build on it with API keys, bots, an event feed and an MCP server for AI assistants.

Quick start

  1. Write compose.yaml and .env from the install guide.

  2. Start it:

    docker compose up -d
  3. Create the first owner:

    docker compose exec yuva /yuva bootstrap --email you@example.com --workspace "Example"
  4. Put it behind HTTPS and sign in with the code that arrives by e-mail.

Documentation

Get started Channels Integrate Build on it
Install E-mail Identity tokens Headless
Configuration Web widget Webhooks AI assistants (MCP)
Operations Mobile SDKs API contract Examples
Documentation pages

How it is built: architecture. What changed: changelog.

Contributing

Read CONTRIBUTING.md first; contributions are made under the CLA. Report security issues privately as described in SECURITY.md.

License

The server and panel are AGPL-3.0. The SDKs (sdk/) and the API contract (openapi/) are MIT, so you can ship them in closed-source apps. Details in LICENSING.md; name and logo in TRADEMARK.md.

“Yuva” is Turkish for nest, or home.

About

Open-source customer messaging for teams with many products: e-mail, live chat and in-app conversations in one inbox. Pre-alpha.

Topics

Resources

Contributing

Security policy

Stars

8 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages