Cirql (pronounced Circle) is a simple and lightweight ORM and query builder for SurrealDB with built in model mapping and validation powered by Zod. Unlike most query builders, Cirql takes a very open approach, providing you with complete control over your queries.
Features
- 🔗 Connect to SurrealDB over stateful WebSockets or stateless requests
- 📦 Support for query batching & transactions
- ⚙️ Zod-powered schema validation of query results
- 📝 Full TypeScript support with Zod schema inference
- 💎 Write flexible queries using the Query Writer API
Notice
Cirql is still in early developmental stages. While you can use it for production applications, it may still lack specific features and edge cases. Feel free to submit feature requests or pull requests to add additional functionality to Cirql. We do ask you to please read our Contributor Guide.
While we try to prevent making any significant API changes, we cannot guarantee this.
Installation
The first step to use Cirql is to install the package from npm, together with a supported version of zod.
npm install cirql zod
How to use
You can read our documentation for information on how to use Cirql.
Contributing
We welcome any issues and PRs submitted to Cirql. Since we currently work on multiple other projects and our time is limited, we value any community help in supporting a rich future for Cirql.
Before you open an issue or PR please read our Contributor Guide.
Requirements
Roadmap
You can find the roadmap of intended features here.
Changelog
The changelog of previous versions can be found here.
Live Development
To run in live development mode, run pnpm dev
in the project directory. This will start the Vite development server.
Maintainers
Cirql is built and maintained by Starlane Studios at no cost. If you would like to support our work feel free to donate to us ⚡
License
Cirql is licensed under MIT
Copyright (c) 2023, Starlane Studios