📚 Goodreads Wrapped

A web application that creates a visualisation of your Goodreads reading activity for the year, inspired by Spotify Wrapped.

Features

• 📊 Visualize your reading statistics for the year
• 📚 View total books and pages read
• ⭐ Analyze your rating distribution
• 📖 Discover your most-read genre
• 🔄 Compare with previous year's reading activity
• 🔗 Share your reading wrap-up with others

Tech Stack

• Framework: Next.js 14
• Styling: Tailwind CSS
• Database: Neon (PostgreSQL)
• ORM: Drizzle
• APIs:
  • Google Books API
  • OpenLibrary API
  • OpenAI API (for genre analysis)

How to Use

1. Export your Goodreads library from Goodreads Export
2. Upload the CSV file to Goodreads Wrapped
3. View your personalized reading statistics
4. Share your wrap-up with friends

Contributing

Contributions are welcome! Please feel free to submit a PR.

Setup

1. Clone the repository
2. Install dependencies:

   npm install

3. Create your environment file:

cp .env.example .env.local

4. Add your OpenAI API key
5. Start the development server

   npm run dev

License

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

Acknowledgments

• Inspired by Spotify Wrapped
• Book cover images provided by Google Books and OpenLibrary APIs
• Genre analysis powered by OpenAI

Author

Ang Li-Lian