Installation#
Get started with Knex Dart in your Dart or Flutter project.
Requirements#
- Dart SDK 3.10.0 or higher
- For Flutter: Flutter 3.22.0 or higher
Packages#
knex_dart is the core query builder. To connect to a database, add the driver package for your database — it pulls in
knex_dart automatically.
| Database | Package | Install |
|---|---|---|
| PostgreSQL | knex_dart_postgres |
dart pub add knex_dart_postgres |
| MySQL | knex_dart_mysql |
dart pub add knex_dart_mysql |
| SQLite | knex_dart_sqlite |
dart pub add knex_dart_sqlite |
Add a Driver#
Pick the driver for your database:
PostgreSQL#
dart pub add knex_dart_postgres
MySQL#
dart pub add knex_dart_mysql
SQLite#
dart pub add knex_dart_sqlite
Query Builder Only#
If you only need SQL generation (no database connection), add the core package directly:
dart pub add knex_dart
This is useful for testing, SQL snapshots, or generating queries to pass to another layer.
Verify Installation#
With a driver (SQLite example)#
import 'package:knex_dart_sqlite/knex_dart_sqlite.dart';
Future<void> main() async {
final db = await KnexSQLite.connect(filename: ':memory:');
print(db('users').select(['id', 'name']).toSQL().sql);
// select "id", "name" from "users"
await db.destroy();
}
Query builder only#
import 'package:knex_dart/knex_dart.dart';
void main() {
// Use a mock client for query generation
final db = Knex(MockClient());
print(db('users').select(['id', 'name']).toSQL().sql);
}
Next Steps#
- Quick Start - Connect and run your first query
- WHERE Clauses - Learn query filtering
- Examples - Real-world patterns