1.5.x docs

src/routes/docs/Sidebar.svelte

@@ -58,6 +58,12 @@
 					href: '/docs/products/storage',
 					icon: 'icon-folder',
 					isParent: true
+				},
+				{
+					label: 'Messaging',
+					href: '/docs/products/messaging',
+					icon: 'icon-send',
+					isParent: true
 				}
 			]
 		},

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

@@ -73,6 +73,10 @@
 					label: 'JWT login',
 					href: '/docs/products/auth/jwt'
 				},
+				{
+					label: 'Multi-factor authentication',
+					href: '/docs/products/auth/mfa'
+				},
 			]
 		},
 		{

src/routes/docs/products/auth/mfa/+page.markdoc

@@ -0,0 +1,167 @@
+---
+layout: article
+title: Multi-factor authentication
+description: Add multiple layers of authentication to your applications powered by Appwrite Authentication.
+---
+
+Multi-factor authentication (MFA) greatly increases the security of your apps by adding additional layers of protection.
+When Multifactor authentication is enabled, a malicious actor needs to compromise multiple authentication factors to gain unauthorized access.
+Appwrite Authentication lets you easily implement MFA in your apps, letting you build more securely and quickly.
+
+Appwrite currently allows two factors of authentication. More factors of authentication will be available soon.
+
+Here are the steps to implement MFA in your application.
+
+{% section #enable-mfa step=1 title="Enable MFA on an account" %}
+[TODO @TorstenDittmann need some advice here, what's the steps?]
+{% /section %}
+{% section #init-login step=2 title="Initialize login" %}
+Begin your login flow with the default authentication method used by your app, for example, email password.
+{% multicode %}
+```js
+import { Client, Account } from "appwrite";
+
+const client = new Client();
+
+const account = new Account(client);
+
+client
+    .setEndpoint('https://cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('5df5acd0d48c2') // Your project ID
+;
+
+await account.createEmailSession(
+    'email@example.com',
+    'password1+'
+);
+```
+
+```dart
+echo 'test';
+```
+
+```kotlin
+print('test');
+```
+
+```swift
+print('test');
+```
+{% /multicode %}
+{% /section %}
+{% section #check-for-2fa step=3 title="Check for multi-factor" %}
+Upon successful login in the first authentication step, check the status of the login by calling `account.get()`.
+If more than one factors are required, you will the error `user_more_factors_required`.
+{% multicode %}
+```js
+try {
+    await account.get();
+} catch (error) {
+    if (error.type === `user_more_factors_required`){
+        // redirect to perform MFA
+    }
+    else {
+        // handle other errors
+    }
+}
+```
+
+```dart
+echo 'test';
+```
+
+```kotlin
+print('test');
+```
+
+```swift
+print('test');
+```
+{% /multicode %}
+{% /section %}
+{% section #list-provider step=4 title="List provider" %}
+You can check which providers are enabled for an account using `account.listProviders()`.
+The returned object will be formatted like this.
+
+```js
+{
+    totp: true, // time-based one-time password
+    email: false, // email
+    phone: true // phone
+}
+```
+
+{% multicode %}
+```js
+const providers = await account.listProviders();
+// redirect based on providers returned.
+```
+
+```dart
+echo 'test';
+```
+
+```kotlin
+print('test');
+```
+
+```swift
+print('test');
+```
+{% /multicode %}
+
+{% /section %}
+{% section #create-challenge step=5 title="Create challenge" %}
+Based on the providers available, initialize an additional auth step.
+Calling these methods will send a challenge to the user.
+{% multicode %}
+```js
+// Authenticator app
+const challenge = await account.createChallenge('totp');
+
+// Email
+const challenge = await account.createChallenge('email');
+
+// Phone
+const challenge = await account.createChallenge('phone');
+```
+
+```dart
+echo 'test';
+```
+
+```kotlin
+print('test');
+```
+
+```swift
+print('test');
+```
+{% /multicode %}
+
+{% /section %}
+{% section #complete-challenge step=6 title="Complete challenge" %}
+Once the user receives the challenge code, you can pass the code back to Appwrite to complete the challenge.
+{% multicode %}
+```js
+// Authenticator app
+await account.updateChallenge(
+    [CHALLENGE_ID],
+    [CHALLENGE_CODE]
+);
+```
+
+```dart
+echo 'test';
+```
+
+```kotlin
+print('test');
+```
+
+```swift
+print('test');
+```
+{% /multicode %}
+
+{% /section %}

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

@@ -0,0 +1,78 @@
+<script lang="ts">
+	import Docs from '$lib/layouts/Docs.svelte';
+	import Sidebar, { type NavParent, type NavTree } from '$lib/layouts/Sidebar.svelte';
+
+	const parent: NavParent = {
+		href: '/docs',
+		label: 'Messaging'
+	};
+
+	const navigation: NavTree = [
+		{
+			label: 'Getting started',
+			items: [
+				{
+					label: 'Overview',
+					href: '/docs/products/messaging'
+				},
+				{
+					label: 'Quick start',
+					href: '/docs/products/messaging/quick-start'
+				}
+			]
+		},
+		{
+			label: 'Concepts',
+			items: [
+				{
+					label: 'Providers',
+					href: '/docs/products/messaging/providers'
+				},
+				{
+					label: 'Targets',
+					href: '/docs/products/messaging/targets'
+				},
+				{
+					label: 'Topics',
+					href: '/docs/products/messaging/topics'
+				},
+				{
+					label: 'Message types',
+					href: '/docs/products/messaging/message-types'
+				},
+
+			]
+		},
+		{
+			label: 'Journeys',
+			items: [
+				{
+					label: 'Send push notifications',
+					href: '/docs/products/messaging/send-push-notifications'
+				},
+				{
+					label: 'Send email messages',
+					href: '/docs/products/messaging/send-email-messages'
+				},
+				{
+					label: 'Send SMS messages',
+					href: '/docs/products/messaging/send-sms-messages'
+				},
+			]
+		},
+		{
+			label: 'References',
+			items: [
+				{
+					label: 'API reference',
+					href: '/docs/references/cloud/client-web/messaging'
+				},
+			]
+		},
+	];
+</script>
+
+<Docs variant="two-side-navs">
+	<Sidebar {navigation} {parent} />
+	<slot />
+</Docs>

src/routes/docs/products/messaging/+page.markdoc

@@ -0,0 +1,12 @@
+---
+layout: article
+title: Messaging
+description: Send push notifications, text, or emails to users or groups of users using your app.
+back: /docs
+---
+
+PLACE HOLDER 
+
+{% arrow_link href="/docs/products/messaging/quick-start" %}
+Quick start 
+{% /arrow_link %}

src/routes/docs/products/messaging/message-types/+page.markdoc

@@ -0,0 +1,9 @@
+---
+layout: article
+title: Message types 
+description: Learn about the different ways you can deliver messages to communicate with your end users.
+---
+
+
+
+

src/routes/docs/products/messaging/providers/+layout@.svelte

@@ -0,0 +1,78 @@
+<script lang="ts">
+	import Docs from '$lib/layouts/Docs.svelte';
+	import Sidebar, { type NavParent, type NavTree } from '$lib/layouts/Sidebar.svelte';
+
+	const parent: NavParent = {
+		href: '/docs/products/messaging',
+		label: 'Providers'
+	};
+
+	const navigation: NavTree = [
+		{
+			label: 'Providers',
+			items: [
+				{
+					label: 'Overview',
+					href: '/docs/products/messaging'
+				},
+			]
+		},
+		{
+			label: 'Push notifications',
+			items: [
+				{
+					label: 'FCM',
+					href: '/docs/products/messaging/providers'
+				},
+				{
+					label: 'APNs',
+					href: '/docs/products/messaging/targets'
+				},
+			]
+		},
+		{
+			label: 'Email',
+			items: [
+				{
+					label: 'Mailgun',
+					href: '/docs/products/messaging/providers/mailgun'
+				},
+				{
+					label: 'Sendgrid',
+					href: '/docs/products/messaging/providers/sendgrid'
+				},
+			]
+		},
+		{
+			label: 'SMS',
+			items: [
+				{
+					label: 'Twillio',
+					href: '/docs/products/messaging/providers/twillio'
+				},
+				{
+					label: 'MSG91',
+					href: '/docs/products/messaging/providers/msg91'
+				},
+				{
+					label: 'Telesign',
+					href: '/docs/products/messaging/providers/telesign'
+				},
+				{
+					label: 'TextMagic',
+					href: '/docs/products/messaging/providers/textmagic'
+				},
+				{
+					label: 'Vonage',
+					href: '/docs/products/messaging/providers/vonage'
+				},
+
+			]
+		},
+	];
+</script>
+
+<Docs variant="two-side-navs">
+	<Sidebar {navigation} {parent} />
+	<slot />
+</Docs>