Likerts README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Likerts listing page.
Likerts
Likerts is a free, open-source backend for surveys embedded in your own web and mobile products. It provides one typed platform through HTTP, MCP and a Rust CLI, with SDKs for Web, React Native, iOS, Android and Flutter.
Download the community release · Installation guide · Contribute
Likerts does not host respondent links or send invitations. Your application decides when a survey appears and supplies the customer context. Likerts validates the published schema, stores the response, returns an idempotent receipt and makes the data available through scoped reads, exports and signed callbacks.
There are no response credits, paid plans, license keys or application-level response quotas. Accepted-response counts are observability data only. Operators still configure request rates, payload bounds, storage capacity and concurrency to protect their infrastructure.
What is included
- Nine question types: single choice, multiple choice, scale, text, number, date, ranking, matrix and constant sum
- NPS and yes/no presets, conditional visibility, pages and branching
- Immutable published survey versions and collection credentials
- PostgreSQL row-level security for workspace isolation
- Scoped service credentials and OAuth grants
- Stable response pagination, privacy-safe aggregates and chart-ready analysis
- Bounded exports, retention and erasure
- Signed response webhooks
- API, MCP and CLI operation parity
- Five client SDKs with encrypted offline queue adapters
Try a real embedded survey
Clone the repository, then run:
Open http://127.0.0.1:4310. Answer the survey, then retrieve the matching response and metadata in the operator view. The example uses the real Web SDK, Rust API and CLI. It requires Rust stable, Node.js 22+ and Bash; temporary memory storage clears when you stop it.
Watch the 40-second walkthrough · Example source and instructions · Versioned downloads and installation
Install in your application
These are client packages; connect them to your Likerts API using the SDK guides or MCP setup. Runnable Next.js, Vue and Svelte hosts demonstrate explicit mounting, cleanup and safe retry of an ambiguous submission. See the installation guide for versions, compatibility and native SDK source.
Follow the tested checkout feedback walkthrough to attach metadata and retrieve a real receipt, or the MCP lifecycle walkthrough to create, publish and manage a survey with scoped tools.
Run with durable local storage
With Docker Compose and OpenSSL installed:
The local guide takes you through your first stored response, stop/restart and explicit reset. For an automated clean-consumer rehearsal using the published CLI and Web SDK, run node scripts/check-newcomer.mjs; see prerequisites and verification boundaries. The API binds only to loopback and PostgreSQL data survives container recreation. This setup uses development authentication; follow the self-host operations guide before any public deployment.
Run the API locally
You need Git, Rust stable, Node.js 22+, Bash and jq. The memory store is intended for a disposable local loop; PostgreSQL is required for durable deployments.
The API listens on http://127.0.0.1:8080. In another terminal:
The script creates and publishes a survey, creates a collection, submits one response twice with the same idempotency key, verifies one stored response, and prints the receipt. The capability reference documents every API, MCP and CLI operation. Tool setup covers the CLI and MCP server.
For PostgreSQL, set DATABASE_URL and use a migration-capable local account with LIKERTS_RUN_MIGRATIONS=1. Production should run migrations separately and connect the API with the restricted runtime role in backend/provision-runtime.sql.
Verify
The checks cover domain validation, interface parity, tenant isolation, durable idempotency, response lifecycle and all five SDK implementations.
Repository map
| Directory | Responsibility |
|---|---|
backend/ | Rust API, domain validation, PostgreSQL repositories and migrations |
contracts/ | OpenAPI, survey schemas and cross-platform fixtures |
tools/mcp/ | Typed MCP adapter |
tools/cli/ | Rust CLI |
sdks/ | Web, React Native, iOS, Android and Flutter SDKs |
control-plane/ | Public site, documentation and optional hosted workspace UI |
infrastructure/ | Render, recovery, export and webhook deployment assets |
Security model
A collection credential can fetch one immutable collection and submit responses to it. Management credentials are workspace-bound and explicitly scoped. PostgreSQL row-level security enforces tenant boundaries beneath the application layer. Browser origins are policy controls and do not replace authentication.
Never put a management credential in a browser or mobile app. Treat metadata as untrusted input and avoid sending secrets or unnecessary personal data. See SECURITY.md for reporting and deployment guidance.
License
Likerts is available under the MIT License.
Contribute
Start with the contribution guide and community roadmap. Pick a good first issue, explore help wanted tasks, or describe your integration in Discussions.
Bug reports, documentation fixes and reproducible integration examples are useful contributions. Each area has focused checks so you can contribute without installing every mobile toolchain. See our code of conduct and maintainer process. For setup problems, see support and troubleshooting.