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/1syB4EHXl9V0QTim57SkRqPtgAdwXTQ0C

Run Locally

Prerequisites: Node.js

1. Install dependencies: npm install
2. Set the GEMINI_API_KEY in .env.local to your Gemini API key
3. Run the app: npm run dev

Deploy to GitHub Pages

This project is configured to automatically deploy to GitHub Pages when you push to the main branch.

Setup Instructions:

1. Add your Gemini API Key as a repository secret:

   • Go to your repository settings
   • Navigate to Settings → Secrets and variables → Actions
   • Click "New repository secret"
   • Name: GEMINI_API_KEY
   • Value: Your Gemini API key
   • Click "Add secret"

   ⚠️ Security Note: This application runs entirely in the browser and the API key will be embedded in the client-side JavaScript. Anyone who visits your deployed site can extract the API key from the page source. To mitigate this risk:

   • Use a restricted API key with usage limits and quotas
   • Consider implementing a backend proxy service for production use
   • Regularly monitor your API usage for any unusual activity

2. Enable GitHub Pages:

   • Go to Settings → Pages
   • Under "Source", select "GitHub Actions"

3. Deploy:

   • Push your changes to the main branch
   • The GitHub Actions workflow will automatically build and deploy your app
   • Your app will be available at: https://AWEplaysStuff.github.io

Manual Deployment:

You can also trigger a manual deployment:

• Go to Actions tab in your repository
• Select "Deploy to GitHub Pages" workflow
• Click "Run workflow"