Transform any X/Twitter username into a unique, AI-generated V0mon avatar! v0mon uses Google's Gemini AI to create personalized V0mon creatures based on usernames, complete with custom types, names, and descriptions.

• AI-Powered Generation: Uses Google Gemini 2.5 Flash to create unique V0mon artwork
• Smart Type System: Assigns 1-2 V0mon types with personality traits matching the username
• Creative Naming: Generates Pokemon-style names inspired by the input username
• Persistent Storage: Saves generated V0mon to prevent regeneration (one per username)
• Social Sharing: Built-in X/Twitter sharing functionality
• Open Graph Support: Custom OG images for social media previews
• Responsive Design: Beautiful UI that works on all devices
• Fast Performance: Built with Next.js 15 and optimized for speed

Visit v0mon.vercel.app to try it out!

• Framework: Next.js 15 with App Router
• AI: Google Gemini 2.5 Flash Image Preview
• Database: PostgreSQL with Drizzle ORM
• Storage: Vercel Blob for image storage
• Styling: Tailwind CSS + shadcn/ui components
• Deployment: Vercel
• Language: TypeScript

• Node.js 18+
• pnpm 8+
• PostgreSQL database
• Google AI API key
• Vercel account (for blob storage)

1. Clone the repository

   git clone https://github.com/decker-dev/v0mon.git cd v0mon

2. Install dependencies

   pnpm install

3. Set up environment variables

   Create a .env.local file in the root directory:

   # Google AI API Key (required) GOOGLE_GENAI_API_KEY=your_google_ai_api_key_here # Database URL (required) DATABASE_URL=postgresql://username:password@localhost:5432/v0mon # Vercel Blob Storage (required for production) BLOB_READ_WRITE_TOKEN=your_vercel_blob_token_here # App URL (for OG images and sharing) NEXT_PUBLIC_BASE_URL=http://localhost:3000

4. Set up the database

   pnpm db:generate pnpm db:migrate

5. Run the development server

   pnpm dev

6. Open your browser

   Navigate to http://localhost:3000

1. Google AI API Key:

   • Visit Google AI Studio
   • Create a new API key
   • Enable Gemini API access

2. Vercel Blob Token:

   • Go to your Vercel dashboard
   • Navigate to Storage → Blob
   • Create a new store and copy the token

The app uses a simple PostgreSQL schema:

CREATE TABLE pokemon ( id TEXT PRIMARY KEY DEFAULT gen_random_uuid(), username TEXT UNIQUE NOT NULL, imageUrl TEXT NOT NULL, type1 TEXT NOT NULL, type2 TEXT, pokemonName TEXT NOT NULL, createdAt TIMESTAMP DEFAULT NOW(), updatedAt TIMESTAMP DEFAULT NOW() );

1. Username Input: User enters an X/Twitter username
2. Type Generation: Algorithm assigns 1-2 random V0mon types
3. AI Prompt Creation: Builds a detailed prompt incorporating:
   • Username characteristics
   • Type-specific personality traits
   • Visual design requirements
4. Image Generation: Google Gemini creates the V0mon artwork
5. Name Extraction: AI generates a creative V0mon name
6. Storage: Image stored in Vercel Blob, metadata in PostgreSQL
7. Sharing: Users can share their V0mon on social media

v0mon/ ├── src/ │ ├── app/ │ │ ├── [username]/ # Dynamic user pages │ │ ├── api/ │ │ │ ├── generate-pokemon/ # Pokemon generation API │ │ │ └── og/ # Open Graph image generation │ │ ├── globals.css │ │ ├── layout.tsx │ │ └── page.tsx # Homepage │ ├── components/ │ │ └── ui/ # shadcn/ui components │ └── lib/ │ ├── db/ # Database configuration │ └── utils.ts ├── drizzle/ # Database migrations ├── public/ # Static assets └── package.json 

1. Connect your repository to Vercel
2. Add environment variables in Vercel dashboard
3. Deploy - Vercel will automatically build and deploy

# Build the project pnpm build # Start production server pnpm start

# Development server with Turbopack pnpm dev # Build for production pnpm build # Start production server pnpm start # Lint code with Biome pnpm lint # Format code with Biome pnpm format # Generate database migrations pnpm db:generate # Run database migrations pnpm db:migrate # Open Drizzle Studio pnpm db:studio

This project is licensed under the MIT License - see the LICENSE file for details.

• V0mon for the inspiration
• Google AI for the Gemini model
• Vercel for hosting and storage
• shadcn/ui for the beautiful components

If you encounter any issues or have questions, please open an issue on GitHub.

Made with ❤️ by decker

Generate your V0mon today at v0mon.vercel.app!