Merge branch 'main' into update-functions-screenshot

Author: ebenezerdon

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/lib/layouts/Docs.svelte

@@ -131,7 +131,7 @@
         </div>
     </section>
     <header
-        class="web-main-header {isReferences ? 'is-reference' : 'is-docs'}"
+        class="web-main-header hidden lg:block {isReferences ? 'is-reference' : 'is-docs'}"
         class:is-transparent={variant !== 'expanded'}
     >
         <div class="web-main-header-wrapper">

src/lib/layouts/Main.svelte

@@ -196,7 +196,9 @@
         </div>
     </section>
 
-    <header class="web-main-header is-special-padding {resolvedTheme} is-transparent">
+    <header
+        class="web-main-header is-special-padding hidden lg:block {resolvedTheme} is-transparent"
+    >
         <div
             class="web-main-header-wrapper"
             class:is-special-padding={BANNER_KEY.startsWith('init-banner-')}

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/(marketing)/(components)/scale.svelte

@@ -25,24 +25,24 @@
         children,
         stats = [
             {
-                number: 12,
-                suffix: '+',
-                description: 'Regions served'
+                number: 50,
+                suffix: 'K+',
+                description: 'GitHub stars'
             },
             {
-                number: 1000,
-                suffix: '+ TB',
-                description: 'of data served'
+                number: 300,
+                suffix: '+',
+                description: 'PoP locations'
             },
             {
-                number: 50,
-                suffix: 'B',
-                description: 'requests'
+                number: 300,
+                suffix: 'K+',
+                description: 'developers'
             },
             {
-                number: 300,
-                suffix: 'K',
-                description: 'projects'
+                number: 200,
+                suffix: 'B+',
+                description: 'monthly database operations'
             }
         ]
     }: Props = $props();

src/routes/(marketing)/+page.svelte

@@ -43,28 +43,6 @@
                 company: 'K-Collect',
                 image: '/images/testimonials/ryan-oconner-testimonial.png'
             }}
-            stats={[
-                {
-                    number: 50,
-                    suffix: 'K+',
-                    description: 'GitHub stars'
-                },
-                {
-                    number: 300,
-                    suffix: '+',
-                    description: 'PoP locations'
-                },
-                {
-                    number: 300,
-                    suffix: 'K+',
-                    description: 'developers'
-                },
-                {
-                    number: 200,
-                    suffix: 'B+',
-                    description: 'monthly database operations'
-                }
-            ]}
         >
             The switch to using Appwrite brought
             <span class="text-primary">infinite value that I'm still discovering today.</span>

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)