Add distribution setup, documentation, and app icons

- Add custom Browserbase app icons (PNG, ICO, ICNS)
- Add JSDoc documentation to all source files
- Update README with download links, build instructions, and hosting guide
- Add GitHub Actions workflow for automated releases
- Add repository metadata to package.json

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: miguelg719

.github/workflows/release.yml

@@ -0,0 +1,99 @@
+name: Build and Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to release (e.g., 1.0.0)'
+        required: false
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            platform: linux
+          - os: windows-latest
+            platform: win
+          - os: macos-latest
+            platform: mac
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build application
+        run: npm run build
+
+      - name: Build distributables (Linux)
+        if: matrix.platform == 'linux'
+        run: npm run dist -- --linux
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build distributables (Windows)
+        if: matrix.platform == 'win'
+        run: npm run dist -- --win
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build distributables (macOS)
+        if: matrix.platform == 'mac'
+        run: npm run dist -- --mac
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-${{ matrix.platform }}
+          path: |
+            release/*.exe
+            release/*.dmg
+            release/*.AppImage
+            release/*.zip
+            release/*.yml
+          if-no-files-found: ignore
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+
+    permissions:
+      contents: write
+
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+          merge-multiple: true
+
+      - name: List artifacts
+        run: ls -la artifacts/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: artifacts/*
+          draft: false
+          prerelease: ${{ contains(github.ref, '-beta') || contains(github.ref, '-alpha') }}
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

README.md

@@ -2,6 +2,18 @@
 
 A high-fidelity Chrome browser interface that proxies all browsing activity through Browserbase remote browsers with advanced stealth enabled. This Electron application makes cloud browser sessions appear and behave as native desktop Chrome instances.
 
+## Download
+
+Download the latest release for your platform:
+
+| Platform | Download |
+|----------|----------|
+| Windows | [Desktop Browserbase Setup.exe](https://github.com/browserbase/desktop-browserbase/releases/latest) |
+| macOS | [Desktop Browserbase.dmg](https://github.com/browserbase/desktop-browserbase/releases/latest) |
+| Linux | [Desktop Browserbase.AppImage](https://github.com/browserbase/desktop-browserbase/releases/latest) |
+
+> **Note:** You'll need a [Browserbase](https://browserbase.com) account with API access to use this application.
+
 ## Features
 
 - **Native Chrome Experience** - Pixel-perfect Chrome v130+ UI styling
@@ -159,6 +171,80 @@ Make sure `BROWSERBASE_API_KEY` and `BROWSERBASE_PROJECT_ID` are set before runn
 - Verify your API key is valid
 - Check the Browserbase status page
 
+## Building for Distribution
+
+To create distributable packages for all platforms:
+
+```bash
+# Build for your current platform
+npm run dist
+
+# Build for specific platforms (requires appropriate OS or CI)
+npm run dist -- --win      # Windows (NSIS installer)
+npm run dist -- --mac      # macOS (DMG)
+npm run dist -- --linux    # Linux (AppImage)
+```
+
+Built packages will be output to the `release/` directory.
+
+### Platform Requirements
+
+- **Windows builds:** Can be built on Windows or via CI
+- **macOS builds:** Must be built on macOS (for code signing)
+- **Linux builds:** Can be built on Linux or via CI
+
+## Hosting Releases
+
+We recommend hosting releases on **GitHub Releases** for the following benefits:
+
+- Free hosting for open source projects
+- Automatic download statistics
+- Integration with GitHub Actions for automated builds
+- Easy versioning with git tags
+- CDN-backed downloads for fast, reliable access
+
+### Release Process
+
+1. Update version in `package.json`
+2. Commit changes and create a git tag:
+   ```bash
+   git tag v1.0.0
+   git push origin v1.0.0
+   ```
+3. GitHub Actions will automatically build and create a release
+
+Alternatively, for private distribution:
+- **AWS S3 + CloudFront**: Scalable, pay-as-you-go hosting
+- **Cloudflare R2**: S3-compatible with generous free tier
+- **Your own server**: Full control over distribution
+
+## Contributing
+
+Contributions are welcome! Please follow these steps:
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/my-feature`
+3. Make your changes and add tests if applicable
+4. Ensure the build passes: `npm run build`
+5. Commit your changes: `git commit -m "Add my feature"`
+6. Push to the branch: `git push origin feature/my-feature`
+7. Open a Pull Request
+
+### Development Guidelines
+
+- Follow the existing code style (TypeScript, ESLint)
+- Add JSDoc comments for new public APIs
+- Test on multiple platforms when possible
+- Keep commits focused and atomic
+
+## Security
+
+This application handles sensitive credentials (API keys). Please:
+
+- Never commit `.env` files or API keys
+- Use environment variables for configuration
+- Report security vulnerabilities via GitHub Security Advisories
+
 ## License
 
 MIT

assets/icons/icon.icns

@@ -13,7 +13,12 @@
     "pack": "npm run build && electron-builder --dir",
     "dist": "npm run build && electron-builder"
   },
-  "author": "",
+  "author": "Browserbase",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/browserbase/desktop-browserbase"
+  },
+  "homepage": "https://browserbase.com",
   "license": "MIT",
   "devDependencies": {
     "@types/node": "^20.10.0",