Merge branch 'main' into header-fix

Author: thejessewinton

STYLE.md

@@ -144,21 +144,21 @@ the tone and voice remains consistent.
 - All titles, headings, buttons, and labels should be written in **sentence case**. If you're not sure what sentence case should look like, check [APA's style guide](https://apastyle.apa.org/style-grammar-guidelines/capitalization/sentence-case) or check with ChatGPT and other LLMs which reliably converts titles to sentence case.
 - All headings in a docs page begin with `# Heading` then `## Heading` and `### Heading`. Internally, they're converted to H2 to H4 tags.
 - All headings should have an ID label, for example `# Cool heading {% #cool-heading %}` the `#cool-heading` ID will be used to generate the table of contents and add links to the heading.
-- Prefer verbs over gerunds, for example, say "Create documents" not "Creating documents".
+- Prefer verbs to gerunds, for example, say "Create documents" not "Creating documents".
 
 ### Extended Markdoc components
 
-Appwrite's documentation uses extended markdown syntax. You can find all of the available partials types in the [CONTENT.md file](./CONTENT.md).
+Appwrite's documentation uses extended Markdown syntax. You can find all the available partials types in the [CONTENT.md file](./CONTENT.md).
 
 ### Screenshots
 
 - When contributing upload original screenshots. The Appwrite design team will edit the screenshot to be consistent with other screenshots in the docs.
 - Screenshots must be 16:9
-- Screnshots should be taken in a 1400 x 900 view port on 3x DPR in browser developer tools.
+- Screenshots should be taken in a 1400 x 900 view port on 3x DPR in browser developer tools.
 - Use generic and sensible organization, project, and resource names. Avoid names like `test`, `demo`, or `sdlkfj`.
-- All screenshot should be take from a user named Walter O'Brien. You can change the name of your current user by going to your Appwrite Console and clicking the **top right profile icon** > **Your Account** > **Name**.
+- All screenshot should be taken from a user named Walter O'Brien. You can change the name of your current user by going to your Appwrite Console and clicking the **top right profile icon** > **Your Account** > **Name**.
 - Screenshots are stored in the `/images/docs/` folder, in a parent folder that is consistent with the path of the docs that reference the image.
-- All screenshots must be both dark and light mode, with `/path/` holding the lightmode version and `/path/dark/` holding the dark mode version.
+- All screenshots must be both dark and light mode, with `/path/` holding the light-mode version and `/path/dark/` holding the dark mode version.
 - Screenshots should be uploaded as un-edited original. Request help from the Appwrite design team to help you edit and refine your photos according to our guidelines.
 
 ```md

src/lib/constants.ts

@@ -66,6 +66,11 @@ export type SearchableCategory = {
 };
 
 export const integrationCategoryDescriptions: SearchableCategory[] = [
+    {
+        slug: 'mcp',
+        heading: 'MCP',
+        description: 'Platforms with Model Context Protocol support'
+    },
     {
         slug: 'ai',
         heading: 'AI',

src/markdoc/nodes/Image.svelte

@@ -42,7 +42,7 @@
     {/if}
 {:else}
     <div class="web-media main">
-        <img {src} {alt} {title} loading="lazy" class="aspect-video w-full" />
+        <img {src} {alt} {title} loading="lazy" class="aspect-video w-full object-cover" />
         <div class="abs">
             <Tooltip closeOnPointerDown>
                 <Button variant="secondary" class="cursor-pointer" action={trigger}>

src/markdoc/tags/TabsItem.svelte

@@ -11,6 +11,13 @@
             context.triggers.push({ id, title });
             return context;
         });
+
+        return () => {
+            ctx.update((context) => {
+                context.triggers = context.triggers.filter((trigger) => trigger.id !== id);
+                return context;
+            });
+        };
     });
 </script>
 

src/routes/blog/post/announcing-appwrite-sites/+page.markdoc

@@ -93,7 +93,7 @@ Spin up your first site from the Console or [CLI](/docs/tooling/command-line/sit
 
 # More resources
 
-- [Appwrite Sites docs](/docs/producst/sites)
+- [Appwrite Sites docs](/docs/products/sites)
 - [Appwrite compared to Vercel](/blog/post/open-source-vercel-alternative)
 - [Appwrite Sites product tour](https://youtu.be/VtDe6hDw91k)
 - [Appwrite Sites video announcement](https://youtu.be/0cERQxFjTW4)

src/routes/blog/post/announcing-csv-imports/+page.markdoc

@@ -0,0 +1,69 @@
+---
+layout: post
+title: "Announcing: Document imports from CSV files"
+description: Learn how to import documents into your Appwrite collections using a simple CSV file, a new feature built on top of Appwrite's migration APIs.
+date: 2025-07-01
+# update this cover later, once available!
+cover: /images/blog/announcing-csv-imports/cover.png
+timeToRead: 5
+author: darshan-pandya
+category: announcement
+featured: false
+---
+
+We're introducing a new way to populate your Appwrite databases: **document imports from CSV files**.
+
+Built on top of Appwrite's migration APIs, this feature makes it easy to bring in large datasets, seed collections, or migrate structured data using only a CSV file.
+
+The CSV document import is useful for migrating user data from external systems, importing inventory records, seeding test environments, or onboarding structured content such as FAQs.
+
+# How it works
+
+To get started, create a collection and define its attributes in the Appwrite Console. Your CSV file should follow a standard format:
+
+- The first row must be a header containing attribute names that match your collection
+- Each subsequent row represents a document, with values separated by commas
+
+{% info title="Good to know" %}
+You can optionally include the `$id` column to assign custom document IDs.
+{% /info %}
+
+![Collections screen](/images/blog/announcing-csv-imports/csv-import.png)
+
+All required attributes must be present in the CSV, and Appwrite will validate each row before importing it.
+
+For example, if your collection contains attributes like `title`, `author`, `year`, and `available`, a valid CSV file would look like this:
+
+```text
+$id,title,author,year,available
+f3k91x8b2q,Harry Potter and the Sorcerer's Stone,J.K. Rowling,1997,true
+mz7lq3dp5c,The Fellowship of the Ring,J.R.R. Tolkien,1954,true
+x0v4p8ncq2,To Kill a Mockingbird,Harper Lee,1960,false
+kq9nmv13ru,The Great Gatsby,F. Scott Fitzgerald,1925,true
+p8lw39xsd1,Catch-22,Joseph Heller,1961,true
+v42cj0quxp,Pride and Prejudice,Jane Austen,1813,true
+```
+
+## Uploading your CSV file
+
+You can upload a new file during import or select an existing one from your project's storage bucket.
+The Console provides a guided interface to help you select the CSV and link it to your target collection. Once uploaded, the import process begins immediately.
+
+## Designed for scale
+
+CSV imports are built to scale seamlessly with your data. Whether you're working with a small dataset or importing production-grade records, the system is designed to handle high volumes reliably and efficiently.
+
+The import system performs per-row validation and runs as a background task, allowing it to handle large files efficiently. This ensures reliable performance across a range of scenarios—from lightweight configuration data to large-scale production imports.
+
+## Availability and resources
+
+CSV imports are now available on **Appwrite Cloud** and in the latest self-hosted release.
+
+To learn more, check out the [official documentation](/docs/products/databases/csv-imports).
+If you have any questions or feedback, we'd love to hear from you in the [Appwrite Discord community](https://discord.gg/appwrite).
+
+# Further reading
+
+- [Introducing Database Backups](https://appwrite.io/blog/post/introducing-database-backups?doFollow=true)
+- [Best database pagination technique](https://appwrite.io/blog/post/best-pagination-technique?doFollow=true)
+- [How to plan and execute database migration successfully with the new Appwrite CLI](https://appwrite.io/blog/post/how-to-execute-database-migration-with-appwrite-cli?doFollow=true)

src/routes/blog/post/csr-ssg-ssr/+page.markdoc

@@ -139,8 +139,8 @@ And the great thing is, if you're using platforms like Appwrite Sites and hybrid
 So if you’re just starting out, don’t stress about choosing the “perfect” rendering mode. Start with the defaults of your framework, and learn when to override them based on what your app needs.
 
 # More resources
-- [Appwrite Sites docs](/docs/producst/sites)
-- [Appwrite Sites prodcuts page](/producst/sites)
+- [Appwrite Sites docs](/docs/products/sites)
+- [Appwrite Sites prodcuts page](/products/sites)
 - [How to host SSR web apps on Appwrite Sites](blog/post/host-ssr-web-apps-sites)
 - [SSR vs CSR with Next.js](/blog/post/csr-vs-ssr-with-nextjs)
 - [Appwrite SSR Authentication](https://www.youtube.com/watch?v=7LN05c-ov_0)

src/routes/blog/post/open-source-netlify-alternative/+page.markdoc

@@ -211,7 +211,7 @@ Appwrite Sites is built for teams that want their frontends to do more, and for
 
 # More resources
 
-- [Appwrite Sites docs](/docs/producst/sites)
+- [Appwrite Sites docs](/docs/products/sites)
 - [Appwrite compared to Vercel](/blog/post/open-source-vercel-alternative)
 - [Appwrite Sites product tour](https://youtu.be/VtDe6hDw91k)
 - [Appwrite Sites video announcement](https://youtu.be/0cERQxFjTW4)

src/routes/changelog/(entries)/2025-07-01.markdoc

@@ -0,0 +1,23 @@
+---
+layout: changelog
+title: "Announcing: Document imports from CSV files"
+date: 2025-07-01
+cover: /images/changelog/2025-07-01.png
+---
+
+We're introducing a new way to populate your Appwrite databases: **document imports from CSV files**.
+
+Using this feature, you can now import documents into your database using just a CSV file without any custom scripts.
+
+Whether you’re:
+
+- Migrating data from another tool
+- Seeding test environments
+- Importing FAQs, inventory, or structured content
+
+You can do it all with a simple CSV file.
+
+{% arrow_link href="/blog/post/announcing-csv-imports" %}
+Read the announcement to learn more
+{% /arrow_link %}
+`

src/routes/docs/products/databases/+layout.svelte

@@ -1,5 +1,6 @@
 <script lang="ts">
     import Docs from '$lib/layouts/Docs.svelte';
+    import { isNewUntil } from '$lib/utils/date';
     import Sidebar, { type NavParent, type NavTree } from '$lib/layouts/Sidebar.svelte';
 
     const parent: NavParent = {
@@ -42,7 +43,8 @@
                 },
                 {
                     label: 'Type Generation',
-                    href: '/docs/products/databases/type-generation'
+                    href: '/docs/products/databases/type-generation',
+                    new: isNewUntil('31 Jul 2025')
                 },
                 {
                     label: 'Offline Sync',
@@ -55,6 +57,11 @@
                 {
                     label: 'Backups',
                     href: '/docs/products/databases/backups'
+                },
+                {
+                    label: 'CSV Imports',
+                    href: '/docs/products/databases/csv-imports',
+                    new: isNewUntil('31 Jul 2025')
                 }
             ]
         },