Merge pull request #2676 from appwrite/full-schema

Full schema

Author: adityaoberai

src/routes/blog/author/aditya-oberai/+page.markdoc

@@ -2,10 +2,10 @@
 layout: author
 slug: aditya-oberai
 name: Aditya Oberai
-role: Developer Advocate
+role: Developer Relations Lead
 bio: Hackathons, communities, developer relations, and open source
 avatar: /images/avatars/aditya.png
-twitter:  https://x.com/adityaoberai1
+twitter:  https://x.com/adityaoberai
 github: https://github.com/adityaoberai
 linkedin:  https://www.linkedin.com/in/adityaoberai1
 ---

src/routes/blog/post/announcing-full-schema-creation/+page.markdoc

@@ -0,0 +1,135 @@
+---
+layout: post
+title: "Announcing Full Schema Creation: Provision complete tables in one atomic call"
+description: Create a table, all its columns, and indexes synchronously, ready to use instantly, with no background jobs.
+date: 2025-12-30
+cover: /images/blog/full-schema.png
+timeToRead: 5
+author: aditya-oberai
+category: announcement
+featured: false
+callToAction: true
+---
+
+When you’re spinning up a new feature, environment, or test pipeline, schema creation shouldn’t be the slowest or most fragile step in your workflow. Yet traditionally, creating a usable table meant orchestrating multiple calls, waiting on async jobs, and hoping nothing failed halfway through.
+
+That’s exactly why we’re announcing **Full Schema Creation** for Appwrite Databases.
+
+With Full Schema Creation, you can define an entire table, its attributes and indexes, in a **single, synchronous request**. When the call returns, the table is immediately ready for reads and writes. If anything fails along the way, nothing is created. No partial schemas. No waiting. No brittle setup scripts.
+
+# One request. One outcome. Fully usable.
+
+Previously, schema provisioning looked something like this:
+
+1. Create a table
+2. Create column
+3. Wait for async column jobs to complete
+4. Create indexes
+5. Wait again
+6. Finally, the table might be usable
+
+This step-wise flow introduced delays, race conditions in automation scripts, and fragile deploys, especially in CI/CD, preview environments, and migrations.
+
+With Full Schema Creation, all of that collapses into a single operation. You define everything upfront, Appwrite validates it all together, and either the entire schema is created successfully, or nothing is.
+
+```js
+const table = await tablesDB.createTable({
+    databaseId: 'contacts_db',
+    tableId: 'contacts',
+    name: 'Contacts',
+    columns: [
+        {
+            key: 'email',
+            type: 'email',
+            required: true
+        },
+        {
+            key: 'name',
+            type: 'string',
+            size: 255,
+            required: true
+        },
+        {
+            key: 'is_active',
+            type: 'boolean',
+            required: true
+        },
+    ],
+    indexes: [
+        {
+            key: 'idx_email',
+            type: 'unique',
+            attributes: ['email']
+        }
+    ]
+});
+```
+
+# How it works
+
+Full Schema Creation introduces an atomic, synchronous way to provision database schemas. Here’s what happens under the hood:
+
+- **Define the full schema in one call**
+    
+    In a single API request, you define:
+    
+    - The table
+    - All columns (type, length, nullability, defaults, enums, relationships)
+    - All indexes
+    
+- **Synchronous apply**
+    
+    Appwrite applies the schema immediately. The request only returns once the table is fully created and ready to read and write, without any background jobs, polling, or delays.
+    
+- **Atomic guarantees**
+    
+    If any part of the schema fails validation, an invalid column, a conflicting index, or a broken relationship reference, the entire operation is rolled back. You’ll never end up with a half-created table.
+
+This makes schema creation deterministic, predictable, and safe, making it ideal for automation-heavy workflows and rapid iteration.
+
+# What this unlocks for you
+
+- **One-shot setup:** Define a complete table in a single, atomic call.
+- **No async waiting:** The table is usable as soon as the API responds.
+- **Fewer moving parts:** Less orchestration means fewer retries and fewer failures.
+- **Deterministic CI/CD:** Reliable schema bootstrapping for tests, previews, and pipelines.
+- **Instant readiness:** Seed data and run integration tests immediately after creation.
+
+# Built for teams that move fast
+
+Full Schema Creation was designed with:
+
+- Backend and platform engineers
+- CI/CD pipelines and test environments
+- Agencies and partners are shipping reusable templates
+- Teams are spinning up many short-lived environments
+
+If your workflow depends on fast and repeatable schema provisioning, this feature eliminates an entire class of setup problems.
+
+## Why this matters for Appwrite
+
+From our side, Full Schema Creation significantly reduces time-to-first-write, helping users activate faster and ship sooner. It also eliminates a common source of schema-related support issues by making database setup simpler, safer, and more predictable.
+
+# Familiar, but better
+
+If this sounds familiar, that’s because similar ideas exist elsewhere:
+
+- SQL databases with `CREATE TABLE` + `CREATE INDEX` in one statement
+- Prisma or Drizzle migrations
+- Hasura metadata applies
+
+What’s different is bringing this experience directly into a BaaS environment—where schema creation has historically been UI-driven or step-wise and async.
+
+# Get started
+
+Full Schema Create is available on **Appwrite Cloud** today and supported on **self-hosted deployments.**
+
+You can now provision complete, production-ready tables in one call, whether you’re bootstrapping a new feature, running CI pipelines, or spinning up preview environments.
+
+No more waiting. No more partial schemas. Just clean, atomic, ready-to-use tables from the moment you create them.
+
+# More resources
+
+- [Announcing API for spatial columns: Build scalable location-aware apps with ease](/blog/post/announcing-spatial-columns)
+- [Announcing an improved Appwrite Databases experience. A completely new look and feel](/blog/post/announcing-appwrite-databases-new-ui)
+- [Announcing Atomic numeric operations: Safe, server-side increments and decrements](/blog/post/announcing-atomic-numeric-operations)

src/routes/changelog/(entries)/2025-12-30

@@ -0,0 +1,14 @@
+---
+layout: changelog
+title: "Announcing Full Schema Creation: Provision complete tables in one atomic call"
+date: 2025-12-30
+cover: /images/blog/full-schema.png
+---
+
+Introducing a new Database feature called Full Schema Creation.
+
+With Full Schema Creation, you can define an entire table, its attributes and indexes, in a single, synchronous request. When the call returns, the table is immediately ready for reads and writes. If anything fails along the way, nothing is created. No partial schemas. No waiting. No brittle setup scripts.
+
+{% arrow_link href="/blog/post/announcing-full-schema-creation" %}
+Read the full announcement
+{% /arrow_link %}