Initial commit

templates/README.md

@@ -0,0 +1,79 @@
+# Google Gemini File Search Templates
+
+This directory contains working example projects demonstrating different deployment patterns for Gemini File Search.
+
+## Templates
+
+### 🚧 basic-node-rag/ (TO BE IMPLEMENTED)
+Minimal Node.js/TypeScript example for learning and prototyping.
+
+**Features:**
+- Simple TypeScript setup
+- Create store → Upload documents → Query → Display citations
+- Single-file example (~200 lines)
+- Perfect for understanding core concepts
+
+**Use When:**
+- Learning File Search API
+- Quick prototyping
+- Building CLI tools
+
+### 🚧 cloudflare-worker-rag/ (TO BE IMPLEMENTED)
+Edge deployment with Cloudflare Workers + R2 integration.
+
+**Features:**
+- Cloudflare Workers with @cloudflare/vite-plugin
+- R2 integration for document storage
+- Edge API endpoints (upload, query)
+- Hybrid architecture (Gemini File Search + Cloudflare edge)
+- Wrangler configuration
+
+**Use When:**
+- Building global edge applications
+- Integrating with Cloudflare stack (D1, R2, KV)
+- Need low-latency worldwide
+
+### 🚧 nextjs-docs-search/ (TO BE IMPLEMENTED)
+Full-stack Next.js application with UI.
+
+**Features:**
+- Next.js 14+ App Router
+- Document upload UI with drag-and-drop
+- Real-time search interface
+- Citation rendering with source links
+- Metadata filtering UI
+- Tailwind CSS + shadcn/ui
+- TypeScript throughout
+
+**Use When:**
+- Building production documentation sites
+- Creating knowledge base UIs
+- Need full-stack app with frontend
+
+## Structure
+
+Each template includes:
+- `README.md` - Setup and deployment instructions
+- `package.json` - Dependencies and scripts
+- `tsconfig.json` - TypeScript configuration
+- `.env.example` - Environment variables template
+- `src/` - Source code
+- Working example with sample data
+
+## Development Status
+
+**Completed:** 0/3 templates (0%)
+
+**Priority:**
+1. basic-node-rag (foundational example)
+2. nextjs-docs-search (most practical for users)
+3. cloudflare-worker-rag (advanced integration)
+
+## Notes
+
+All templates demonstrate:
+- Proper error handling from SKILL.md
+- Recommended chunking configurations
+- Metadata schema best practices
+- Operation polling patterns
+- Cost-aware implementations