🌟 WikiTimeline

Transform Wikipedia articles into beautiful, interactive timelines powered by AI

Live Demo • Features • Installation • Usage

✨ Features

• 🔄 Instant Conversion: Transform any Wikipedia article into a timeline in seconds
• 🤖 AI-Powered: Utilizes Google Gemini to extract and organize chronological events
• 📱 Responsive Design: Beautiful interface that works on all devices
• 🌓 Dark Mode: Seamless experience in both light and dark themes
• 🔄 Multi-Timeline: Compare multiple timelines side by side
• 🎯 Interactive: Zoom, scroll, and explore events interactively

🚀 Installation

1. Clone the repository:

git clone https://github.com/wenzhenl/wikitimeline.git
cd wikitimeline

2. Install dependencies:

npm install

3. Set up environment variables:

cp .env.example .env.development.local

4. Configure your environment variables:

   • Get a Gemini API key from Google AI Studio
   • Set up Vercel KV storage:
     1. Install Vercel CLI: npm i -g vercel
     2. Link your project: vercel link
     3. Create a KV storage in Vercel Dashboard
     4. Connect KV to your project
     5. Pull environment variables: vercel env pull .env.development.local

5. Run the development server:

npm run dev

🌐 Deployment

1. Deploy to Vercel:

vercel deploy

2. Configure production environment variables in Vercel Dashboard:
   • Add all variables from .env.example
   • Connect Vercel KV storage

💡 Usage

1. Visit the homepage
2. Search for any Wikipedia topic
3. Select from the autocomplete suggestions
4. Click "Generate Timeline" to view your interactive timeline
5. For multiple timelines, keep adding topics before generating

🎯 Example Timelines

• George Washington & Qianlong Emperor - Two great leaders, two empires, one era

• The Three Titans - Renaissance masters who shaped art history

• The Poet Saints - China's greatest poets of the Golden Age

🛠️ Tech Stack

• Framework: Next.js 14 with App Router
• Styling: Tailwind CSS
• Database: Vercel KV (Redis)
• AI: Cursor/Claude for development, Gemini for timeline generation
• Deployment: Vercel

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📝 License

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

---

Built by Wenzheng Li (aka Steven Lee)