Merge branch 'main' of github.com:drizzle-team/drizzle-orm-docs

Author: AndriiSherman

src/components/markdown/get-started/mysql/ConnectPlanetScale.mdx

@@ -3,7 +3,7 @@ Create a `index.ts` file in the `src/db` directory and initialize the connection
 ```typescript copy
 import { drizzle } from "drizzle-orm/planetscale-serverless";
 
-const db = await drizzle({ connection: {
+const db = drizzle({ connection: {
   host: process.env.DATABASE_HOST!,
   username: process.env.DATABASE_USERNAME!,
   password: process.env.DATABASE_PASSWORD!,

src/components/markdown/get-started/postgresql/ConnectNeon.mdx

@@ -7,7 +7,7 @@ Create a `index.ts` file in the `src/db` directory and initialize the connection
 ```typescript
 import { drizzle } from 'drizzle-orm/neon-http';
 
-const db = await drizzle("neon-http", process.env.DATABASE_URL);
+const db = drizzle(process.env.DATABASE_URL);
 ```
 
 If you need a synchronous connection, you can use our additional connection API, 
@@ -18,5 +18,5 @@ import { neon } from '@neondatabase/serverless';
 import { drizzle } from 'drizzle-orm/neon-serverless';
 
 const sql = neon(process.env.DATABASE_URL!);
-const db = drizzle(sql);
+const db = drizzle({ client: sql });
 ```

src/components/markdown/get-started/postgresql/ConnectPgLite.mdx

@@ -1,24 +1,17 @@
 Create a `index.ts` file in the `src/db` directory and initialize the connection:
 
 ```typescript copy
-import { drizzle } from 'drizzle-orm/connect';
-
-async function main() {
-    const db = drizzle('pglite', process.env.DATABASE_URL!);
-}
+import { drizzle } from 'drizzle-orm/pglite';
 
-main();
+const db = drizzle(process.env.DATABASE_URL!);
 ```
 
-If you need a synchronous connection, you can use our additional connection API, 
-where you specify a driver connection and pass it to the Drizzle instance.
+If you need to provide your existing driver:
 
 ```typescript copy
 import { PGlite } from '@electric-sql/pglite';
 import { drizzle } from 'drizzle-orm/pglite';
 
-async function main() {
-    const client = new PGlite(process.env.DATABASE_URL!);
-    const db = drizzle(client);
-}
+const client = new PGlite(process.env.DATABASE_URL!);
+const db = drizzle({ client });
 ```

src/components/markdown/get-started/postgresql/ConnectPostgreSQL.mdx

@@ -14,7 +14,7 @@ import 'dotenv/config';
 import { drizzle } from 'drizzle-orm/node-postgres';
 
 // You can specify any property from the node-postgres connection options
-const db = await drizzle("node-postgres", { 
+const db = drizzle({ 
   connection: { 
     connectionString: process.env.DATABASE_URL!,
     ssl: true

src/components/markdown/get-started/postgresql/ConnectVercel.mdx

@@ -1,25 +1,16 @@
 Create a `index.ts` file in the `src/db` directory and initialize the connection:
 
 ```typescript copy
-import { drizzle } from 'drizzle-orm/connect';
-
-async function main() {
-    const db = await drizzle("vercel-postgres");
-}
+import { drizzle } from 'drizzle-orm/vercel-postgres';
 
-main();
+const db = drizzle();
 ```
 
-If you need a synchronous connection, you can use our additional connection API, 
-where you specify a driver connection and pass it to the Drizzle instance.
+If you need to provide your existing driver:
 
 ```typescript copy
 import { sql } from '@vercel/postgres';
 import { drizzle } from 'drizzle-orm/vercel-postgres';
 
-async function main() {
-    const db = drizzle(sql)
-}
-
-main();
+const db = drizzle({ client: sql })
 ```

src/components/markdown/get-started/sqlite/ConnectBun.mdx

@@ -5,39 +5,25 @@ Create a `index.ts` file in the `src` directory and initialize the connection:
 <CodeTabs items={["libsql", "libsql with config"]}>
 ```typescript copy
 import 'dotenv/config';
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/bun:sqlite';
 
-async function main() {
-  const db = await drizzle("bun:sqlite", process.env.DB_FILE_NAME!);
-}
-
-main();
+const db = drizzle(process.env.DB_FILE_NAME!);
 ```
 ```typescript copy
 import 'dotenv/config';
-import { drizzle } from 'drizzle-orm/connect';
-
-async function main() {
-  // You can specify any property from the libsql connection options
-  const db = await drizzle("bun:sqlite", { connection: { source: process.env.DB_FILE_NAME! }});
-}
+import { drizzle } from 'drizzle-orm/bun:sqlite';
 
-main();
+// You can specify any property from the libsql connection options
+const db = drizzle({ connection: { source: process.env.DB_FILE_NAME! }});
 ```
 </CodeTabs>
 
-If you need a synchronous connection, you can use our additional connection API, 
-where you specify a driver connection and pass it to the Drizzle instance.
-
+If you need to provide your existing driver:
 ```typescript copy
 import 'dotenv/config';
 import { drizzle } from 'drizzle-orm/bun-sqlite';
 import { Database } from 'bun:sqlite';
 
-async function main() {
-  const sqlite = new Database(process.env.DB_FILE_NAME!);
-  const db = drizzle(sqlite);
-}
-
-main();
+const sqlite = new Database(process.env.DB_FILE_NAME!);
+const db = drizzle({ client: sqlite });
 ```

src/components/markdown/get-started/sqlite/ConnectLibsql.mdx

@@ -2,53 +2,29 @@ import CodeTabs from "@mdx/CodeTabs.astro";
 
 Create a `index.ts` file in the `src` directory and initialize the connection:
 
-<CodeTabs items={["libsql", "libsql with config", "turso alias"]}>
+<CodeTabs items={["libsql", "libsql with config"]}>
 ```typescript copy
 import 'dotenv/config';
-import { drizzle } from 'drizzle-orm/connect';
-
-async function main() {
-  const db = await drizzle("libsql", process.env.DB_FILE_NAME!);
-}
-
-main();
-```
-```typescript copy
-import 'dotenv/config';
-import { drizzle } from 'drizzle-orm/connect';
-
-async function main() {
-  // You can specify any property from the libsql connection options
-  const db = await drizzle("libsql", { connection: { url: process.env.DB_FILE_NAME! }});
-}
+import { drizzle } from 'drizzle-orm/libsql';
 
-main();
+const db = drizzle(process.env.DB_FILE_NAME!);
 ```
 ```typescript copy
 import 'dotenv/config';
-import { drizzle } from 'drizzle-orm/connect';
-
-async function main() {
-  // You can specify any property from the libsql connection options
-  const db = await drizzle("turso", { connection: { url: process.env.DB_FILE_NAME! }});
-}
+import { drizzle } from 'drizzle-orm/libsql';
 
-main();
+// You can specify any property from the libsql connection options
+const db = drizzle({ connection: { url: process.env.DB_FILE_NAME! }});
 ```
 </CodeTabs>
 
-If you need a synchronous connection, you can use our additional connection API, 
-where you specify a driver connection and pass it to the Drizzle instance.
+If you need to provide your existing driver:
 
 ```typescript copy
 import 'dotenv/config';
 import { drizzle } from 'drizzle-orm/libsql';
 import { createClient } from '@libsql/client';
 
-async function main() {
-  const client = createClient({ url: process.env.DB_FILE_NAME! });
-  const db = drizzle(client);
-}
-
-main();
+const client = createClient({ url: process.env.DB_FILE_NAME! });
+const db = drizzle({ client });
 ```

src/components/markdown/get-started/sqlite/QueryTurso.mdx

@@ -5,11 +5,12 @@ Let's **update** the `src/index.ts` file with queries to create, read, update, a
 <CodeWithProps dialect={props.dialect} env_variable={props.env_variable}>
 ```typescript copy filename="src/index.ts"
 import 'dotenv/config';
-import { drizzle, eq } from 'drizzle-orm';
+import { eq } from 'drizzle-orm';
+import { drizzle } from 'drizzle-orm/libsql';
 import { usersTable } from './db/schema';
 
 async function main() {
-  const db = await drizzle("turso", { 
+  const db = drizzle({ 
     connection: { 
         url: process.env.TURSO_DATABASE_URL!, 
         authToken: process.env.TURSO_AUTH_TOKEN!

src/components/markdown/get-started/sqlite/QueryTursoUpdated.mdx

@@ -5,11 +5,12 @@ Let's **update** the `src/index.ts` file with queries to create, read, update, a
 <CodeWithProps dialect={props.dialect} env_variable={props.env_variable}>
 ```typescript copy filename="src/index.ts"
 import 'dotenv/config';
-import { drizzle, eq } from 'drizzle-orm';
+import { eq } from 'drizzle-orm';
+import { drizzle } from 'drizzle-orm/libsql';
 import { usersTable } from './db/schema';
 
 async function main() {
-  const db = await drizzle("turso", { 
+  const db = drizzle({ 
     connection: { 
         url: process.env.TURSO_DATABASE_URL!, 
         authToken: process.env.TURSO_AUTH_TOKEN!

src/content/documentation/docs/connect-aws-data-api-pg.mdx

@@ -22,11 +22,11 @@ drizzle-orm @aws-sdk/client-rds-data
 
 #### Step 2 - Initialize the driver and make a query
 ```typescript copy
-import { drizzle } from 'drizzle-orm/connect';
+import { drizzle } from 'drizzle-orm/aws-data-api-pg';
 
 // These three properties are required. You can also specify
 // any property from the RDSDataClient type inside the connection object.
-const db = drizzle('aws-data-api-pg', { connection: {
+const db = drizzle({ connection: {
   database: process.env['DATABASE']!,
   secretArn: process.env['SECRET_ARN']!,
   resourceArn: process.env['RESOURCE_ARN']!,
@@ -35,8 +35,7 @@ const db = drizzle('aws-data-api-pg', { connection: {
 await db.select().from(...);
 ```
 
-If you need a synchronous connection, you can use our additional connection API, 
-where you specify a driver connection and pass it to the Drizzle instance.
+If you need to provide your existing driver:
 
 ```typescript copy
 import { drizzle } from 'drizzle-orm/aws-data-api/pg';