diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..40fa51d
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,2 @@
+# Copy this file to .env and fill in your API key
+GEMINI_API_KEY=your_api_key_here
diff --git a/.gitignore b/.gitignore
index a547bf3..1cac559 100644
--- a/.gitignore
+++ b/.gitignore
@@ -22,3 +22,4 @@ dist-ssr
*.njsproj
*.sln
*.sw?
+.env
\ No newline at end of file
diff --git a/README.md b/README.md
index 5cc8ef4..b49d47c 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,60 @@
-
-
-
-
-# Run and deploy your AI Studio app
-
-This contains everything you need to run your app locally.
-
-View your app in AI Studio: https://ai.studio/apps/drive/1Di9b15uKTFXVof4InO8oefefCDaW9Q26
-
-## Run Locally
-
-**Prerequisites:** Node.js
+## Run locally
+Prerequisites: Node.js (16+ recommended)
1. Install dependencies:
- `npm install`
-2. Set the `GEMINI_API_KEY` in [.env.local](.env.local) to your Gemini API key
-3. Run the app:
- `npm run dev`
+
+ npm install
+
+2. Copy the example env and (optionally) add your Gemini API key:
+
+ cp .env.example .env
+
+ If you set `GEMINI_API_KEY`, the project can be wired to a real image
+ generation backend. For local development, if the key is empty the app
+ will show a placeholder generated image so the UI remains usable.
+
+3. Start the dev server:
+
+ npm run dev
+
+## Run as an Electron app (local desktop)
+
+1. Install dev dependencies (if not already done):
+
+ npm install
+
+2. Start the app in Electron (dev):
+
+ npm run electron:dev
+
+This runs Vite and then launches Electron pointed at the dev server. The renderer will use a preload bridge to ask the main process to perform avatar generation — you can extend the main process to call the `@google/genai` SDK safely.
+
+## Tailwind CSS and production
+
+- The app previously used the Tailwind CDN for convenience. For production we now build Tailwind locally using PostCSS (the project contains `tailwind.config.cjs` and `postcss.config.cjs`).
+- To build for production (or package with Electron), run:
+
+ npm run build
+
+- If you need to customize Tailwind, edit `tailwind.config.cjs` and your global styles in `src/styles.css`.
+
+## Electron security note (CSP)
+
+During development Electron warns about a permissive Content-Security-Policy (CSP). This is expected for dev, but before shipping an Electron app you must set a strict CSP and avoid `unsafe-eval` and `unsafe-inline` where possible. See: https://electronjs.org/docs/tutorial/security
+
+---
+
+Refactor notes
+
+The repository was reorganized so renderer and electron-specific code live under `src/`:
+
+- `src/renderer` — React application and browser-only services/components
+- `src/electron` — main process, preload, and GenAI wrapper
+- `src/shared` — types and small shared artifacts
+
+Vite alias `@` now points to `src/` so you can import shared files as `@/shared/types`.
+
+Compatibility: root-level electron entry files were kept as small wrappers that forward to the `src/electron` files so existing scripts should still work.
+
+If you want further adjustments (different folders or moving more files), tell me and I will apply them.
diff --git a/index.html b/index.html
index cda6e43..99e7b27 100644
--- a/index.html
+++ b/index.html
@@ -3,9 +3,13 @@
- Gemini V-Studio
-
+ Vtube Studio
+
+
+
+
+
-
+