Merge branch 'main' into add-project-v-docs

Author: adityaoberai

CONTENT.md

@@ -1,12 +1,10 @@
 # Content Guidelines
 
-## Table of Contents
-
-### Basics
+## Basics
 
 Here are some essential markdoc syntax elements with code examples:
 
-#### Paragraphs and Line Breaks
+### Paragraphs and Line Breaks
 
 To create a new paragraph, simply leave a blank line between lines of text.
 
@@ -16,7 +14,7 @@ This is the first paragraph.
 This is the second paragraph.
 ```
 
-#### Headers
+### Headers
 
 Headers are used to create section titles. Use hashtags (#) for headers, with more hashtags for lower-level headers.
 
@@ -34,7 +32,7 @@ Headers can also be given ID's so they can be linked to and are present in the T
 # Header with ID {% #header-with-id %}
 ```
 
-#### Lists
+### Lists
 
 Create ordered (numbered) and unordered (bulleted) lists using 1., \*, or -.
 
@@ -54,7 +52,7 @@ Create ordered (numbered) and unordered (bulleted) lists using 1., \*, or -.
 - Cherry
 ```
 
-#### Links
+### Links
 
 Create hyperlinks to other web pages or sections within your documentation.
 
@@ -63,7 +61,7 @@ Create hyperlinks to other web pages or sections within your documentation.
 [Link to Section](#section-name)
 ```
 
-#### Images
+### Images
 
 Embed images using the `![alt text](image URL)` syntax.
 
@@ -82,7 +80,7 @@ In most cases, we need images in both light and dark mode such as:
 {% /only_light %}
 ```
 
-#### Code Blocks
+### Code Blocks
 
 Format code blocks using triple backticks (```).
 
@@ -95,15 +93,15 @@ def hello_world():
 
 Remember to use a specific language label if the code is using an Appwrite SDK. Find the [list of available labels here](https://github.com/appwrite/website/blob/41bb6c71a8647016c88393003d3cf6c4edba1f76/src/lib/utils/references.ts#L26).
 
-#### Inline Code
+### Inline Code
 
 Highlight inline code with backticks (`) around the code snippet.
 
 ```md
 Use the `print()` function to display text.
 ```
 
-#### Emphasis and Strong Text
+### Emphasis and Strong Text
 
 Use asterisks (\*) or underscores (\_) for emphasis and double asterisks or underscores for strong text.
 
@@ -114,7 +112,7 @@ _Italic Text_ or _Italic Text_
 **Bold Text** or **Bold Text**
 ```
 
-#### Tables
+### Tables
 
 Tables allow you to display structured data in your documentation. Use pipes (|) to separate columns and hyphens (-) to define the table header.
 
@@ -146,7 +144,7 @@ Alternatively, use markdoc tables.
 {% /table %}
 ```
 
-#### Block Quotes
+### Block Quotes
 
 Block quotes are used to emphasize or highlight text. To create a block quote, use the > symbol at the beginning of the quoted text.
 
@@ -157,9 +155,9 @@ Block quotes are used to emphasize or highlight text. To create a block quote, u
 
 These are the fundamental Markdown syntax elements you'll need to create well-structured and formatted documentation.
 
-### Components
+## Components
 
-#### Tabs
+### Tabs
 
 ```md
 {% tabs %}
@@ -173,7 +171,7 @@ Lorem ipsum dolor sit amet consectetur.
 {% /tabs %}
 ```
 
-#### Multicode Examples
+### Multicode Examples
 
 <pre>
 {% multicode %}
@@ -191,7 +189,9 @@ print('test');
 {% /multicode %}
 </pre>
 
-#### Sections
+Remember to use a specific language label if the code is using an Appwrite SDK. Find the [list of available labels here](https://github.com/appwrite/website/blob/41bb6c71a8647016c88393003d3cf6c4edba1f76/src/lib/utils/references.ts#L26).
+
+### Sections
 
 Use sections when there is a clear step-by-step format to a page. This is used mainly in journey pages and tutorials.
 
@@ -209,15 +209,15 @@ Lorem ipsum dolor sit amet consectetur.
 {% /section %}
 ```
 
-#### Info
+### Info
 
 ```
 {% info title="Public Service Announcement" %}
 Lorem ipsum dolor sit amet consectetur.
 {% /info %}
 ```
 
-#### Icon
+### Icon
 
 Available sizes are `s`, `m`, `l` and `xl`. Default: `s`.
 
@@ -228,7 +228,7 @@ Available sizes are `s`, `m`, `l` and `xl`. Default: `s`.
 {% icon icon="github" size="xl" /%}
 ```
 
-#### Icon Image
+### Icon Image
 
 Available sizes are `s`, `m`, `l` and `xl`. Default: `s`.
 
@@ -239,7 +239,7 @@ Available sizes are `s`, `m`, `l` and `xl`. Default: `s`.
 {% icon_image src="/icon.png" alt="Icon" size="xl" /%}
 ```
 
-#### Only Light/Dark Theme
+### Only Light/Dark Theme
 
 ```
 {% only_dark %}
@@ -250,7 +250,7 @@ Available sizes are `s`, `m`, `l` and `xl`. Default: `s`.
 {% /only_light %}
 ```
 
-#### Cards
+### Cards
 
 We use cards when we reference a list of links for navigation
 
@@ -276,7 +276,7 @@ Get started with Appwrite and SvelteKit
 {% /cards %}
 ```
 
-#### Cards with icons
+### Cards with icons
 
 We use cards when we reference a list of links for navigation, this variation has icons for extra hints visually.
 
@@ -294,7 +294,7 @@ Configure FCM for push notification to Android and Apple devices.
 {% /cards %}
 ```
 
-#### Accordions
+### Accordions
 
 Use accordions to reduce page size and collapse information that's not important when a reader is scrolling the page.
 

README.md

@@ -41,4 +41,4 @@ Join our growing community around the world! See our official [Blog](https://app
 
 ## License
 
-Appwrite website, docs and blog © 2024 by Appwrite is licensed under [CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/).
+Appwrite website, docs and blog © 2025 by Appwrite is licensed under [CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/).

STYLE.md

@@ -332,6 +332,13 @@ or a page needs to be sufficiently different from existing pages, follow exisitn
 
 If you are proposing a new type of page, discuss an outline in your PR and ask for the Appwrite team's review.
 
+### Placeholders
+
+Whenever there's a need for a placeholder such as for an ID, use angle brackets (<>) over square brackets ([]) because square brackets can be confused for an array.
+
+- ✅ `client.setEndpoint("https://<REGION>.cloud.appwrite.io")`
+- ❌ `client.setEndpoint("https://[REGION].cloud.appwrite.io")`
+
 ## Code snippets
 
 For quick starts and tutorials, a developer must be able to follow code examples from beginning to end

pnpm-lock.yaml

@@ -8,15 +8,15 @@ type SocialStats = {
 
 export const SOCIAL_STATS: SocialStats = {
     GITHUB: {
-        STAT: '48K',
+        STAT: '50K',
         LINK: 'https://github.com/appwrite/appwrite',
         EXTRA: {
-            COMMITS: '24K+',
-            PULL_REQUESTS: '4.5K+',
+            COMMITS: '27K+',
+            PULL_REQUESTS: '4.7K+',
             ISSUES: '3K+',
-            OPEN_ISSUES: '500+',
+            OPEN_ISSUES: '600+',
             CLOSED_ISSUES: '3.3K+',
-            FORKS: '4.3K+',
+            FORKS: '4.4K+',
             CONTRIBUTORS: '800+'
         }
     },
@@ -29,7 +29,7 @@ export const SOCIAL_STATS: SocialStats = {
         LINK: 'https://twitter.com/intent/follow?screen_name=appwrite'
     },
     YOUTUBE: {
-        STAT: '11K+',
+        STAT: '12K+',
         LINK: 'https://www.youtube.com/c/appwrite?sub_confirmation=1'
     }
 };

src/lib/constants.ts

@@ -15,6 +15,8 @@
     import PosterDeploy from './(assets)/posterDeploy.png';
     import PosterIndustryPanel from './(assets)/posterIndustryPanel.png';
     import PosterNewImageFormats from './(assets)/posterNewImageFormats.png';
+    import PosterFileTokens from './(assets)/posterFileTokens.png';
+    import PosterClosingParty from './(assets)/eventClosingParty.png';
     import Sites from './(assets)/illustrations/sites.svg';
     import Flutter from './(assets)/illustrations/flutter.svg';
     import Formats from './(assets)/illustrations/formats.svg';
@@ -173,36 +175,36 @@
             illustration: Tokens,
             description:
                 'Introducing File Tokens. This feature lets you share files easily and securely, without modifying permissions or changing project access. Just generate a token and share the link.',
-            url: 'https://youtu.be/_XU1dftsQag',
+            url: 'https://www.youtube-nocookie.com/embed/eiwCCjBD3cw',
             content: [
                 {
-                    title: 'Serverless functions 101: best practices',
+                    title: 'Announcing File Tokens: secure file sharing without the hassle',
                     url: '/blog/post/announcing-file-tokens',
                     type: 'Blog'
                 },
                 {
-                    title: 'file tokens',
-                    url: '/blog/post',
+                    title: 'CSR vs SSG vs SSR: what they are and how to choose',
+                    url: '/blog/post/csr-ssg-ssr',
                     type: 'Blog'
                 },
                 {
                     title: 'File Tokens',
-                    url: '/docs/',
+                    url: '/docs/products/storage/file-tokens',
                     type: 'Docs',
                     label: 'Visit docs'
                 }
             ],
             announcementVideo: {
-                url: 'https://www.youtube-nocookie.com/embed/2KAwVoJh8a8',
+                url: 'https://www.youtube-nocookie.com/embed/eiwCCjBD3cw',
                 title: 'Announcement Video',
-                poster: Poster
+                poster: PosterFileTokens
             },
             links: [
                 {
                     title: 'YouTube Live',
                     type: 'video',
-                    poster: PosterFutureAppwrite,
-                    url: 'https://www.youtube.com/watch?'
+                    poster: PosterClosingParty,
+                    url: 'https://www.youtube.com/watch?v=1gvjqV1nq-c?'
                 }
             ]
         }

src/routes/(init)/init/(assets)/posterFileTokens.png

@@ -0,0 +1,11 @@
+---
+layout: author
+name: Darshan Pandya
+slug: darshan-pandya
+role: Product Engineer
+bio: Self-taught developer. Mobile apps. Wandering through code & curiosity.
+avatar: /images/avatars/darshan.png
+twitter: https://twitter.com/itznotabug
+github: https://github.com/itznotabug
+linkedin: https://www.linkedin.com/in/itznotabug
+---

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

@@ -0,0 +1,59 @@
+---
+layout: post
+title: "Announcing File Tokens: secure file sharing without the hassle"
+description: File Tokens make sharing files from Appwrite simple, secure, and hassle-free. It’s the fastest way to collaborate externally without compromising control.
+date: 2025-05-23
+cover: /images/blog/file-tokens.png
+timeToRead: 5
+author: darshan-pandya
+category: product
+featured: false
+---
+
+Until now, sharing files from Appwrite often meant navigating permissions, managing access, or making files public, even when all you wanted was to send a file to someone outside your project. With Appwrite 1.7, we have introduced a new feature that will make file sharing a whole lot easier.
+
+Introducing **File Tokens.**
+
+This feature lets you share files easily and securely, without modifying permissions or changing project access. Just generate a token and share the link.
+
+# Simplifying file access
+
+Appwrite Storage has always made it easy to upload, store, and manage your files. But sharing them? That required extra steps.
+
+With File Tokens, you can now share files with **anyone**, without needing to:
+
+- Change file permissions
+- Make files public
+- Invite users to your project
+
+Just create a token and send the link. The file is accessible; no account or permissions are needed.
+
+# Important features
+
+- **Secure token-based sharing**: Generate a token and share the file link instantly.
+- **No permission changes required**: Keep your file rules intact—tokens work independently.
+- **Configurable expiration**: Just like API Keys, File Tokens come with configurable expiration logic, giving you control over how long access is available.
+- **Perfect for external collaboration**: Great for sharing assets, reports, or temporary resources with clients, teammates, or partners.
+- **Works with Cloud and Self-hosted**: Full support across all Appwrite environments.
+
+Everything happens through the Appwrite Console or API, and works seamlessly with your existing files.
+
+# Why it matters
+
+Today, sharing files externally means breaking your app’s permission model or onboarding outside users. That’s not scalable, and it creates friction.
+
+File Tokens fix this. They give you a simple, secure way to share files without reworking your setup or exposing your project to risk.
+
+# Built for flexibility
+
+File Tokens were designed for developers, teams, and organizations that need to **collaborate beyond their apps**. Whether you’re sharing mockups with a client, logs with a teammate, or documents with a partner, File Tokens gives you a flexible and secure solution.
+
+# How to get started
+
+File Tokens are available now in your Appwrite Console. Pick a file, create a token, and share the generated link. [Visit the documentation](/docs/products/storage/file-tokens) to learn more.
+
+# One link, no limits
+
+You needed a better way to share files, and File Tokens deliver. Whether you collaborate with people outside your app or just want a faster way to get files into the right hands, this feature is for you. File Tokens work seamlessly with the preview, view, and download endpoints, making secure file access straightforward and flexible.
+
+Try File Tokens today on **Appwrite Cloud** or in your **self-hosted** project.