docs: updated setup guide to have more detailed instructions

README.md

@@ -74,112 +74,206 @@ https://thinktank.ottomator.ai
 
 If you're new to installing software from GitHub, don't worry! If you encounter any issues, feel free to submit an "issue" using the provided links or improve this documentation by forking the repository, editing the instructions, and submitting a pull request. The following instruction will help you get the stable branch up and running on your local machine in no time.  
 
-### Prerequisites  
+Let's get you up and running with the stable version of Bolt.DIY!
 
-1. **Install Git**: [Download Git](https://git-scm.com/downloads)  
-2. **Install Node.js**: [Download Node.js](https://nodejs.org/en/download/)  
+## Quick Download
 
-   - After installation, the Node.js path is usually added to your system automatically. To verify:  
-     - **Windows**: Search for "Edit the system environment variables," click "Environment Variables," and check if `Node.js` is in the `Path` variable.  
-     - **Mac/Linux**: Open a terminal and run:  
-       ```bash  
-       echo $PATH  
-       ```  
-       Look for `/usr/local/bin` in the output.  
+[![Download Latest Release](https://img.shields.io/github/v/release/stackblitz-labs/bolt.diy?label=Download%20Bolt&sort=semver)](https://github.com/stackblitz-labs/bolt.diy/releases/latest/download/bolt.diy.zip) ← Click here to download the latest version!
 
-### Clone the Repository  
+## Prerequisites
 
-Clone the repository using Git:  
+Before you begin, you'll need to install two important pieces of software:
 
-```bash  
-git clone -b stable https://github.com/stackblitz-labs/bolt.diy  
-```  
+### Install Node.js
 
----
+Node.js is required to run the application.
+
+1. Visit the [Node.js Download Page](https://nodejs.org/en/download/)
+2. Download the "LTS" (Long Term Support) version for your operating system
+3. Run the installer, accepting the default settings
+4. Verify Node.js is properly installed:
+   - **For Windows Users**:
+     1. Press `Windows + R`
+     2. Type "sysdm.cpl" and press Enter
+     3. Go to "Advanced" tab → "Environment Variables"
+     4. Check if `Node.js` appears in the "Path" variable
+   - **For Mac/Linux Users**:
+     1. Open Terminal
+     2. Type this command:
+        ```bash
+        echo $PATH
+        ```
+     3. Look for `/usr/local/bin` in the output
+
+## Running the Application
+
+You have two options for running Bolt.DIY: directly on your machine or using Docker.
 
-## Run the Application  
+### Option 1: Direct Installation (Recommended for Beginners)
 
-### Option 1: Without Docker
+1. **Install Package Manager (pnpm)**:
+   ```bash
+   npm install -g pnpm
+   ```
 
-1. **Install Dependencies**:  
-   ```bash  
-   pnpm install  
-   ```  
-   If `pnpm` is not installed, install it using:  
-   ```bash  
-   sudo npm install -g pnpm  
-   ```  
+2. **Install Project Dependencies**:
+   ```bash
+   pnpm install
+   ```
 
-2. **Start the Application**:  
-   ```bash  
-   pnpm run dev  
+3. **Start the Application**:
+   ```bash
+   pnpm run dev
    ```
-   This will start the Remix Vite development server. You will need Google Chrome Canary to run this locally if you use Chrome! It's an easy install and a good browser for web development anyway.  
 
-### Option 2: With Docker  
+   **Important Note**: If you're using Google Chrome, you'll need Chrome Canary for local development. [Download it here](https://www.google.com/chrome/canary/)
+
+### Option 2: Using Docker
 
-#### Prerequisites  
-- Ensure Git, Node.js, and Docker are installed: [Download Docker](https://www.docker.com/)  
+This option requires some familiarity with Docker but provides a more isolated environment.
 
-#### Steps  
+#### Additional Prerequisite
+- Install Docker: [Download Docker](https://www.docker.com/)
 
-1. **Build the Docker Image**:  
+#### Steps:
 
-   Use the provided NPM scripts:  
-   ```bash  
-   npm run dockerbuild 
-   ```  
+1. **Build the Docker Image**:
+   ```bash
+   # Using npm script:
+   npm run dockerbuild
 
-   Alternatively, use Docker commands directly:  
-   ```bash  
+   # OR using direct Docker command:
    docker build . --target bolt-ai-development
-   ```  
+   ```
+
+2. **Run the Container**:
+   ```bash
+   docker-compose --profile development up
+   ```
 
-2. **Run the Container**:  
-   Use Docker Compose profiles to manage environments:  
-   ```bash  
-   docker-compose --profile development up 
-   ```  
 
-   - With the development profile, changes to your code will automatically reflect in the running container (hot reloading).  
 
----
 
-### Entering API Keys
+## Configuring API Keys and Providers
 
-All of your API Keys can be configured directly in the application. Just selecte the provider you want from the dropdown and click the pencile icon to enter your API key.
+### Adding Your API Keys
 
----
+Setting up your API keys in Bolt.DIY is straightforward:
+
+1. Open the home page (main interface)
+2. Select your desired provider from the dropdown menu
+3. Click the pencil (edit) icon
+4. Enter your API key in the secure input field
+
+![API Key Configuration Interface](./docs/images/api-key-ui-section.png)
+
+### Configuring Custom Base URLs
+
+For providers that support custom base URLs (such as Ollama or LM Studio), follow these steps:
+
+1. Click the settings icon in the sidebar to open the settings menu
+   ![Settings Button Location](./docs/images/bolt-settings-button.png)
 
-### Update Your Local Version to the Latest
+2. Navigate to the "Providers" tab
+3. Search for your provider using the search bar
+4. Enter your custom base URL in the designated field
+   ![Provider Base URL Configuration](./docs/images/provider-base-url.png)
 
-To keep your local version of bolt.diy up to date with the latest changes, follow these steps for your operating system:
+> **Note**: Custom base URLs are particularly useful when running local instances of AI models or using custom API endpoints.
 
-#### 1. **Navigate to your project folder**  
-   Navigate to the directory where you cloned the repository and open a terminal:
+### Supported Providers
+- Ollama
+- LM Studio
+- OpenAILike
 
-#### 2. **Fetch the Latest Changes**  
-   Use Git to pull the latest changes from the main repository:
 
+
+## Setup Option 3: Git Clone (For Developers only)
+
+This method is recommended for developers who want to:
+- Contribute to the project
+- Stay updated with the latest changes
+- Switch between different versions
+- Create custom modifications
+
+#### Prerequisites
+1. Install Git: [Download Git](https://git-scm.com/downloads)
+
+#### Initial Setup
+
+1. **Clone the Repository**:
    ```bash
-   git pull origin main
+   # Using HTTPS
+   git clone https://github.com/stackblitz-labs/bolt.diy.git
    ```
 
-#### 3. **Update Dependencies**  
-   After pulling the latest changes, update the project dependencies by running the following command:
+2. **Navigate to Project Directory**:
+   ```bash
+   cd bolt.diy
+   ```
 
+3. **Switch to the Main Branch**:
    ```bash
-   pnpm install
+   git checkout main
    ```
 
-#### 4. **Run the Application**  
-   Once the updates are complete, you can start the application again with:
+4. **Install Dependencies**:
+   ```bash
+   pnpm install
+   ```
 
+5. **Start the Development Server**:
    ```bash
    pnpm run dev
    ```
 
-This ensures that you're running the latest version of bolt.diy and can take advantage of all the newest features and bug fixes.
+#### Staying Updated
+
+To get the latest changes from the repository:
+
+1. **Save Your Local Changes** (if any):
+   ```bash
+   git stash
+   ```
+
+2. **Pull Latest Updates**:
+   ```bash
+   git pull origin main
+   ```
+
+3. **Update Dependencies**:
+   ```bash
+   pnpm install
+   ```
+
+4. **Restore Your Local Changes** (if any):
+   ```bash
+   git stash pop
+   ```
+
+#### Troubleshooting Git Setup
+
+If you encounter issues:
+
+1. **Clean Installation**:
+   ```bash
+   # Remove node modules and lock files
+   rm -rf node_modules pnpm-lock.yaml
+
+   # Clear pnpm cache
+   pnpm store prune
+
+   # Reinstall dependencies
+   pnpm install
+   ```
+
+2. **Reset Local Changes**:
+   ```bash
+   # Discard all local changes
+   git reset --hard origin/main
+   ```
+
+Remember to always commit your local changes or stash them before pulling updates to avoid conflicts.
 
 ---
 

app/commit.json

@@ -1 +1 @@
-{ "commit": "a9309161e95a8ed015f2f71b622fb63afdb74877", "version": "0.0.3" }
+{ "commit": "a1e902fe7963fa2008c8b30f1cb8be9281146bb2" }