Xgarden

### Basic Information

**Extension Name**: XGarden - AI Interactive Storytelling

**Category**: Productivity

**Language**: English (Primary), Chinese (Secondary)

---

## Summary (132 characters max)

```
Create interactive story worlds with AI characters. Free Gemini API support. Build worlds, chat with NPCs, immersive chapters.
```

---

## Detailed Description

```
XGarden is an open-source Chrome extension for AI-powered interactive storytelling and world-building.

✨ KEY FEATURES

🎭 Character & World Management
• Create custom NPCs with unique personalities and avatars
• Design your player character with custom traits
• Build immersive story worlds with worldbook entries
• Organize characters into groups for multi-character conversations

📖 Dynamic Chapter System
• Create story chapters with custom backgrounds and music
• Auto-progression based on time, keywords, or AI judgment
• Chapter-specific visual and audio experiences
• Seamless transitions between story segments

🤖 AI Integration
• Free Google Gemini API support (recommended)
• OpenAI compatible APIs
• Natural, context-aware conversations
• Smart worldbook integration for rich storytelling

🎨 Rich Media Experience
• Beautiful background images for each chapter
• Atmospheric background music
• Visual effects and overlays
• Music control with play/pause toggle

💾 Full Data Control
• All data stored locally in your browser
• Import/export worlds as JSON files
• Multiple world support
• No cloud storage required

🆓 COMPLETELY FREE
• No subscription or hidden fees
• Use free Gemini API from Google AI Studio
• Open-source and community-driven
• Regular updates and improvements

Perfect for:
• Interactive fiction writers and creators
• RPG and tabletop gaming enthusiasts
• Creative storytelling and worldbuilding
• Educational scenarios and simulations
• AI experimentation and learning

Get started in minutes:
1. Install the extension
2. Get a free Gemini API key from Google AI Studio
3. Create your first world
4. Start chatting with AI characters!

Open Source: https://github.com/jhfnetboy/InfinityGarden
Documentation: Full setup guide included
Community: Active development and support
```

---

## Privacy Policy

```
XGarden Privacy Policy

Last Updated: January 21, 2025

DATA STORAGE
All user data (worlds, characters, conversations, settings) is stored locally in your browser using IndexedDB. We do not collect, transmit, or store any of your data on external servers.

API KEYS
Your AI API keys (Google Gemini, OpenAI, Volcengine Jimeng) are stored securely in Chrome's local storage. We never access, transmit, or share your API keys with any third parties.

THIRD-PARTY SERVICES
XGarden integrates with the following third-party services, which you must configure with your own API keys:

1. Google Gemini API (Optional)
- Used for: AI-powered character conversations
- Privacy Policy: https://ai.google.dev/gemini-api/terms
- You control: Your own API key and usage

2. OpenAI Compatible APIs (Optional)
- Used for: Alternative AI conversation providers
- Privacy Policy: Varies by provider
- You control: Your own API key and usage

3. Volcengine Jimeng API (Optional)
- Used for: AI image generation (future feature)
- Privacy Policy: https://www.volcengine.com/docs/6348/68918
- You control: Your own API key and usage

DATA COLLECTION
We do not collect any personal information, analytics, or usage data. The extension operates entirely locally on your device.

PERMISSIONS
• storage: Store your worlds, characters, and settings locally
• tabs: Open extension in new tab for better user experience

CONTACT
For privacy questions or concerns: [your-email@example.com]

CHANGES TO POLICY
We will notify users of any privacy policy changes through extension updates.
```

---

## Screenshots Guide

### Required Screenshots (1280x800 or 640x400)

#### Screenshot 1: World Selector
**Caption**: "Create and manage multiple story worlds"
**What to show**:
- World selector interface
- Multiple worlds listed
- "Create New World" button
- Clean, organized layout

#### Screenshot 2: Chat Interface with Background
**Caption**: "Immersive conversations with beautiful backgrounds"
**What to show**:
- Active chat with AI character
- Background image visible
- Message bubbles
- Music control button in header

#### Screenshot 3: Character Creation
**Caption**: "Design unique characters with personalities"
**What to show**:
- Character dialog open
- Fields filled in (name, persona, greeting)
- Avatar preview
- "Create Character" button

#### Screenshot 4: Worldbook Panel
**Caption**: "Build rich worlds with chapters and lore"
**What to show**:
- Worldbook panel open
- Tabs: Entries and Chapters
- World defaults section
- List of entries or chapters

#### Screenshot 5: Settings Dialog
**Caption**: "Easy setup with free Gemini API"
**What to show**:
- Settings dialog
- AI Config tab selected
- Gemini selected as provider
- Link to get API key

---

## Promotional Images (Optional but Recommended)

### Small Tile (440x280)
**Design Elements**:
- XGarden logo/icon
- Tagline: "AI Interactive Storytelling"
- Key feature icons (character, world, AI)
- Clean, modern design

### Marquee (1400x560)
**Design Elements**:
- Hero image with background
- XGarden branding
- "Create Your Story Worlds"
- Feature highlights
- "Free & Open Source" badge

---

## Support Information

**Website**: https://github.com/jhfnetboy/InfinityGarden

**Support Email**: [your-email@example.com]

**Support URL**: https://github.com/jhfnetboy/InfinityGarden/issues

---

## Version Information

**Current Version**: 0.1.3

**Version Name**: Immersive Storytelling Update

**What's New**:
```
v0.1.3 - Immersive Storytelling Update

NEW FEATURES:
• World default backgrounds and music
• Chapter-specific media (images & music)
• Music control toggle button
• Enhanced worldbook organization
• Image API configuration (Jimeng)

IMPROVEMENTS:
• Better background image display
• Auto-save for world defaults
• Improved error handling
• Enhanced debugging

BUG FIXES:
• Fixed database prefix issues
• Fixed dialog click propagation
• Fixed maximize button state
• Fixed background loading
```

---

## Keywords (for search optimization)

```
AI, storytelling, interactive fiction, worldbuilding, character creation, RPG, chatbot, Gemini, OpenAI, creative writing, narrative, chapters, immersive, free, open source
```

---

## Developer Information

**Developer Name**: XGarden Team

**Developer Website**: https://github.com/jhfnetboy/InfinityGarden

**Developer Email**: [your-email@example.com]

---

## Justification for Permissions

### storage
**Justification**: "Required to store user-created worlds, characters, conversations, and settings locally in the browser. All data remains on the user's device and is never transmitted to external servers."

### tabs
**Justification**: "Allows users to open the extension in a new tab for a better full-screen experience. This provides more space for worldbuilding and character interactions."

---

## Testing Instructions for Reviewers

1. Install the extension
2. Click the extension icon to open
3. Create a new world (no API key required for testing UI)
4. Add a character (fill in name and persona)
5. Navigate through worldbook panel
6. Check settings dialog
7. Verify all features work without errors

Note: AI features require user's own API key (free from Google AI Studio)

---

## Additional Notes

- Extension is completely free and open-source
- No monetization or ads
- Regular updates planned
- Active community support
- Educational and creative use cases