From eb4b5a6a1ff9025f7e342ac1dbbb962cc15f3c17 Mon Sep 17 00:00:00 2001
From: Philippe Serhal <philippe.serhal@netlify.com>
Date: Mon, 3 Nov 2025 13:04:17 -0500
Subject: [PATCH] docs: add `netlify init` configuration steps for Netlify

Using the Netlify CLI automatically configures the build settings, so this commit documents this as
the preferred configuration approach.
---
 .../docs/features/deployment/providers.md     | 35 +++++++++++++++++--
 1 file changed, 32 insertions(+), 3 deletions(-)

diff --git a/apps/docs-app/docs/features/deployment/providers.md b/apps/docs-app/docs/features/deployment/providers.md
index 7b2c44268..047477a96 100644
--- a/apps/docs-app/docs/features/deployment/providers.md
+++ b/apps/docs-app/docs/features/deployment/providers.md
@@ -140,12 +140,41 @@ You can also check out [Github Integration](https://docs.zerops.io/references/gi
 
 Analog supports deploying on [Netlify](https://netlify.com/) with minimal configuration.
 
-### Deploying the Project
+### Deploying the project
 
 <Tabs groupId="porject-type">
   <TabItem label="Create analog" value="create-analog">
-In the build settings of your Netlify project, set the [publish directory](https://docs.netlify.com/configure-builds/overview/#definitions) to `dist/analog/public` to deploy the static assets and the [functions directory](https://docs.netlify.com/configure-builds/overview/#definitions) to `dist/analog` to deploy the server.
-  </TabItem>
+Configuration is easiest when using [Netlify CLI](https://developers.netlify.com/cli/).
+    
+1. Start by running this command:
+
+```bash
+npx netlify init
+```
+
+If this is a new Netlify project, you'll be prompted to initialize it; build settings will be automatically configured in a `netlify.toml` file.
+
+2. If you're using server-side functionality, you need to manually set the functions directory to `dist/analog` in your `netlify.toml`:
+
+```toml
+[build]
+  command = "npm run build"
+  publish = "dist/analog/public"
+  functions = "dist/analog" # ← update this
+```
+
+3. Finally, deploy your app:
+
+```bash
+npx netlify deploy
+```
+
+#### Manual configuration
+
+Alternatively, you can configure your project's build settings in the Netlify app.
+
+Set the [publish directory](https://docs.netlify.com/configure-builds/overview/#definitions) to `dist/analog/public` to deploy the static assets and the [functions directory](https://docs.netlify.com/configure-builds/overview/#definitions) to `dist/analog` to deploy the server.
+</TabItem>
 
   <TabItem label="Nx" value="nx">
 In the build settings of your Netlify project on the web UI, do the following.