Add deploy scripts, env-based config, and docs updates (#18)

* Add environment-aware token server URL and deploy-website script

Replace hardcoded token server URLs in Widget.astro and Head.astro with
PUBLIC_SERVER_URL env var, allowing localhost for dev and a deployer-provided
URL for production. Add deploy-website npm script, env var guard in the
deploy shell script, .env.example template, and TypeScript env declaration.

* Enable interactive highlights in astrophotography demo

* Add deploy-token-server npm script with .env support

Add deploy-token-server script to package.json, create root .env.example
for GCP_PROJECT_ID, and update deploy-token-server.sh to source root .env
when the env var is not already set.

* Update README with logo, badges, setup docs, and add LICENSE

Add ArionTalk logo variants (light/dark) with GitHub picture element,
Gemini Live and Chrome badges, env file setup in Development section,
updated token server deployment docs, and MIT license file.

* Update favicon to use accent logo

* Serve logo from ariontalk.com and add public logo images

Author: luixaviles

.env.example

@@ -0,0 +1,5 @@
+# Google Cloud project ID — required for Cloud Run deployments (deploy-token-server).
+GCP_PROJECT_ID=your-gcp-project-id
+
+# GCP region — optional, defaults to us-central1.
+# GCP_REGION=us-central1

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Luis Aviles
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,4 +1,30 @@
-# ArionTalk
+# ArionTalk - Voice AI Agent for Any Website
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: light)" srcset="https://ariontalk.com/images/logo-full-light.svg" />
+    <source media="(prefers-color-scheme: dark)" srcset="https://ariontalk.com/images/logo-full-dark.svg" />
+    <img src="https://ariontalk.com/images/logo-full-light.svg" alt="ArionTalk Logo" width="200" />
+  </picture>
+</p>
+
+<p align="center">
+  <a href="https://www.typescriptlang.org/">
+    <img src="https://img.shields.io/badge/TypeScript-5.x-blue?logo=typescript" alt="TypeScript" />
+  </a>
+  <a href="https://nodejs.org/">
+    <img src="https://img.shields.io/badge/Node.js-22%2B-green?logo=node.js" alt="Node.js" />
+  </a>
+  <a href="https://ai.google.dev/gemini-api/docs/live">
+    <img src="https://img.shields.io/badge/Gemini_Live-API-8E75B2?logo=googlegemini&logoColor=white" alt="Gemini Live" />
+  </a>
+  <a href="https://www.google.com/chrome/">
+    <img src="https://img.shields.io/badge/Chrome-139%2B-4285F4?logo=googlechrome&logoColor=white" alt="Chrome 139+" />
+  </a>
+  <a href="https://opensource.org/licenses/MIT">
+    <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" />
+  </a>
+</p>
 
 A voice AI agent that understands your webpage — reads your content, sees your images, and highlights what it's talking about. Powered by Gemini Live.
 
@@ -151,14 +177,19 @@ git clone https://github.com/luixaviles/ariontalk.git
 cd ariontalk
 pnpm install
 pnpm build
+
+# Configure environment
+cp packages/token-server/.env.example packages/token-server/.env
+# Edit packages/token-server/.env and add your GEMINI_API_KEY
+
+cp website/.env.example website/.env
+# Defaults to http://localhost:3001 — no changes needed for local dev
 ```
 
 ### Run with Gemini Live
 
 ```bash
 # Terminal 1: Start the token server
-cp packages/token-server/.env.example packages/token-server/.env
-# Edit .env and add your GEMINI_API_KEY
 pnpm token-server
 # Runs on http://localhost:3001
 
@@ -184,27 +215,32 @@ pnpm test
 
 ### Token Server on Google Cloud Run
 
-The token server is a lightweight Node.js HTTP server built with [Hono](https://hono.dev/). Deploy it to Google Cloud Run:
+**One-time GCP setup:**
 
 ```bash
-# Build and deploy
-gcloud run deploy ariontalk-token-server \
-  --source packages/token-server \
-  --set-env-vars GEMINI_API_KEY=your-key \
-  --allow-unauthenticated \
-  --region us-central1
+gcloud auth login
+GCP_PROJECT_ID=your-project ./scripts/setup-gcp.sh
 ```
 
-Then point your widget to the deployed URL:
+This enables required APIs, creates an Artifact Registry repository, and stores your `GEMINI_API_KEY` in Secret Manager.
 
-```html
-<ariontalk-widget
-  engine="gemini"
-  token-server="https://ariontalk-token-server-xxxxx.run.app/api/token"
-  interactive-highlights
-></ariontalk-widget>
+Save your project ID so the deploy script picks it up automatically:
+
+```bash
+cp .env.example .env
+# Edit .env and set GCP_PROJECT_ID
 ```
 
+**Deploy:**
+
+```bash
+pnpm deploy-token-server
+```
+
+Builds a Docker image, pushes to Artifact Registry, and deploys to Cloud Run. The `GEMINI_API_KEY` is pulled from Secret Manager at runtime — never passed in plain text.
+
+You can also pass the project ID inline: `GCP_PROJECT_ID=your-project pnpm deploy-token-server`.
+
 ## Tech Stack
 
 - **[Gemini Live API](https://ai.google.dev/)** — Real-time multimodal voice streaming with function calling
@@ -222,9 +258,6 @@ Then point your widget to the deployed URL:
 | Gemini Live | Any modern browser | Requires WebSocket + microphone access |
 | Local | Chrome 139+ | Requires Prompt API origin trial |
 
-## Bundle Size
-
-~12-16 KB gzipped (widget + Lit, excluding engine add-ons).
 
 ## License
 

demo/astrophotography.html

@@ -302,7 +302,7 @@ <h2>Getting Started Tonight</h2>
     </article>
   </main>
 
-  <ariontalk-widget id="widget" engine="gemini" token-server="http://localhost:3001/api/token" lang="en" settings log-level="debug"></ariontalk-widget>
+  <ariontalk-widget id="widget" engine="gemini" token-server="http://localhost:3001/api/token" lang="en" interactive-highlights settings log-level="debug"></ariontalk-widget>
   <script type="module">
     import '@ariontalk/widget';
     import { initToolbar } from './scripts/toolbar.js';

package.json

@@ -9,7 +9,9 @@
     "test": "pnpm -r test",
     "website": "pnpm --filter @ariontalk/website dev",
     "website-build": "pnpm --filter @ariontalk/website build",
-    "website-preview": "pnpm --filter @ariontalk/website preview"
+    "website-preview": "pnpm --filter @ariontalk/website preview",
+    "deploy-website": "./scripts/deploy-website.sh",
+    "deploy-token-server": "./scripts/deploy-token-server.sh"
   },
   "devDependencies": {
     "@changesets/cli": "^2.27.0"

scripts/deploy-token-server.sh

@@ -6,8 +6,15 @@ ROOT_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
 
 cd "${ROOT_DIR}"
 
+# Load root .env if GCP_PROJECT_ID is not already set
+if [ -z "${GCP_PROJECT_ID:-}" ] && [ -f "${ROOT_DIR}/.env" ]; then
+  set -a
+  source "${ROOT_DIR}/.env"
+  set +a
+fi
+
 # ── Configuration ──
-PROJECT_ID="${GCP_PROJECT_ID:?Set GCP_PROJECT_ID env var}"
+PROJECT_ID="${GCP_PROJECT_ID:?Set GCP_PROJECT_ID env var or add it to .env}"
 REGION="${GCP_REGION:-us-central1}"
 SERVICE_NAME="ariontalk-token-server"
 REPO_NAME="ariontalk"

scripts/deploy-website.sh

@@ -6,14 +6,28 @@ ROOT_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
 
 cd "${ROOT_DIR}"
 
+# Load .env.production if PUBLIC_SERVER_URL is not already set
+if [ -z "${PUBLIC_SERVER_URL:-}" ] && [ -f "website/.env.production" ]; then
+  set -a
+  source website/.env.production
+  set +a
+fi
+
+# Ensure the production token server URL is set
+if [ -z "${PUBLIC_SERVER_URL:-}" ]; then
+  echo "ERROR: PUBLIC_SERVER_URL is not set."
+  echo "Set it as an env var or in website/.env.production"
+  exit 1
+fi
+
 echo "==> Installing dependencies"
 pnpm install --frozen-lockfile
 
 echo "==> Building all packages"
 pnpm build
 
 echo "==> Building website"
-pnpm website-build
+PUBLIC_SERVER_URL="${PUBLIC_SERVER_URL}" pnpm website-build
 
 echo "==> Deploying to Firebase Hosting"
 firebase deploy --only hosting

website/.env.example

@@ -0,0 +1,5 @@
+# Base URL of the token server — the widget appends /api/token automatically.
+# For local development, run `pnpm token-server` and use the default below.
+# For production, create .env.production with your deployed token server URL.
+# Example: PUBLIC_SERVER_URL=https://my-token-server-xxxxx.us-central1.run.app
+PUBLIC_SERVER_URL=http://localhost:3001