📚Pouranik - Read. Share. Connect.

A cozy digital library and community corner for every reader. Discover books, join reading circles, track your goals, and share your love for stories, all in one open-source platform.

---

What's Pouranik?

Pouranik is an open-source book exploration and reading habit platform designed for people who believe books are more than just words, they’re experiences. Whether you love self-help, fantasy, biographies, technology, or ancient literature, Pouranik is your place to connect with stories and people who share your passion..

---

Why the name "Pouranik"?

The word Paurāṇika comes from Sanskrit, meaning ancient, mythical, or timeless.

We chose this name because stories, whether from ancient scriptures or modern fiction, are timeless.
Pouranik is built on that idea: to help people connect with the magic of reading, share thoughts, and grow together through books.

---

Features

• Book Search – Explore titles from Google Books and Open Library APIs
• Genre-based Browsing – Fiction, Self-Help, Technology, and more
• Book Detail Pages – Summaries, ratings, and user reviews
• Community Reviews – Share and read opinions from other readers
• Book Clubs & Groups – Build your own reading circles
• Reading Goals & Timer Tracker – Stay on track with your habits
• User Profiles & Shelves – Organize books as To-Read, Currently Reading, or Finished
• Language & Accessibility Support – For a global community
• Coming Soon – Real-time group messaging, event planning for clubs, and more

Want to help bring these features to life? Scroll to the contributions section!

---

Why Pouranik is Unique

• More than a Library– It’s a community-driven reading journey.
• Social Reading Experience – Book clubs, group chats, and collaborative goals.
• Sustainable Reading – Buy/sell second-hand books, reducing waste.
• Habit Tracking Built-in – Integrated timers and progress tracking to help you finish books.
• Inclusive for All – Multi-language support and accessibility-first design.

---

Future Scope

• AI-powered Book Recommendations based on your reading patterns.
• Gamified Reading Challenges with badges and leaderboards.
• Event Scheduling for online/offline book discussions.
• Integration with E-Readers for direct progress syncing.
• Advanced Search & Filters (by author, publication date, ratings).
• Personalized Feed showing updates from your groups and interests.
• Voice Book Reviews for accessibility and engagement.

---

Here is the updated announcement text for your project, "pouranik," with the corrected link information and the official GSSoC'25 link included.

🌟 Exciting News...

🚀 This project is now an official part of GirlScript Summer of Code – GSSoC'25! 💻 We're thrilled to welcome contributors from all over India and beyond to collaborate, build, and grow pouranik! Let’s make learning and career development smarter – together! 🌟

GirlScript Summer of Code (GSSoC) is one of India’s largest 3-month-long open-source programs that encourages developers of all levels to contribute to real-world projects while learning, collaborating, and growing together.

🌈 With mentorship, community support, and collaborative coding, it's the perfect platform for developers to:

✨ Improve their skills

🤝 Contribute to impactful projects

🏆 Get recognized for their work

📜 Receive certificates and swag!

🎉 I can’t wait to welcome new contributors from GSSoC 2025 to this pouranik project family! Let's build, learn, and grow together — one commit at a time.

Tech Stack

Layer	Technology
Frontend	React + Tailwind CSS
API	Google Books API / OpenLibrary API
Backend	Node.js + Express (planned)
Database	MongoDB / Firebase (planned)
Hosting	Vercel / Render

---

📂 Project Structure

Pouranik/
├── .github/                          # GitHub configuration files
│   ├── ISSUE_TEMPLATE/               # Issue/PR template markdowns
│   │   ├── bug_report.md
│   │   ├── custom.md
│   │   └── feature_request.md
│   └── workflows/                    # GitHub Actions workflows (CI/CD pipeline)
│       ├── cicd.yaml
│       ├── greetings.yaml
│       └── update_contributors.yaml
├── backend/                          # Backend (Node.js/Express API)
│   ├── Controllers/                  # API route controllers (business logic)
│   │   ├── book.controller.js
│   │   ├── genbook.controller.js
│   │   ├── review.controller.js
│   │   └── user.controller.js
│   ├── DBConfig/                     # Database connection utilities
│   │   └── dbConnect.js
│   ├── Middlewares/                  # Middleware (auth, etc.)
│   │   └── auth.js
│   ├── Models/                       # Mongoose models
│   │   ├── bookrev.model.js
│   │   └── user.model.js
│   ├── Routes/                       # Route definitions (Express routers)
│   │   ├── books.route.js
│   │   ├── genbook.route.js
│   │   ├── index.js
│   │   ├── reviews.route.js
│   │   └── user.route.js
│   ├── .env.example                  # Example environment variables
│   ├── .eslintrc.json                # ESLint config for backend
│   ├── .gitignore                    # Backend ignore rules
│   ├── package-lock.json
│   ├── package.json
│   └── server.js                     # API server entry point
├── frontend/                         # Frontend (React + Vite)
│   ├── public/                       # Public assets (served at root)
│   ├── src/                          # All frontend source code
│   │   ├── assets/                   # Images and animation assets
│   │   │   ├── _animation/           # Animation JSON/Lottie files
│   │   │   ├── book-club.png
│   │   │   ├── cover.png
│   │   │   ├── fantasy.png
│   │   │   ├── mystery.png
│   │   │   ├── react.svg
│   │   │   ├── romance.png
│   │   │   ├── science-fic.png
│   │   │   └── young-adult.png
│   │   ├── components/               # Component modules by feature/type
│   │   │   ├── _global/                  # Common, shared UI components
│   │   │   ├── Library_components/       # Components for user's library
│   │   │   ├── ReadingTracker/           # Reading tracker UI components
│   │   │   ├── Reviews/                  # Book reviews UI
│   │   │   ├── AuthForm.jsx
│   │   │   ├── AuthorRecommendation.jsx
│   │   │   ├── BookCard.jsx
│   │   │   ├── Footer.jsx
│   │   │   ├── Navbar.jsx
│   │   │   ├── NoBookFound.jsx
│   │   │   ├── NoCover.jsx
│   │   │   ├── Pagination.jsx
│   │   │   ├── QuickFilters.jsx
│   │   │   ├── SearchAutocomplete.jsx
│   │   │   ├── SortAndFilterControls.jsx
│   │   │   └── TourOverlay.jsx
│   │   ├── pages/                    # Page-level React components (routes/views)
│   │   │   ├── about.jsx
│   │   │   ├── AISummarySection.jsx
│   │   │   ├── AnalyticsPage.jsx
│   │   │   ├── BookDetail.jsx
│   │   │   ├── club.css
│   │   │   ├── ClubPage.jsx
│   │   │   ├── community.css
│   │   │   ├── Community.jsx
│   │   │   ├── Explore.jsx
│   │   │   ├── Explore.module.css
│   │   │   ├── Genres.css
│   │   │   ├── Genres.jsx
│   │   │   ├── Home.jsx
│   │   │   ├── Library.jsx
│   │   │   ├── Reviews.jsx
│   │   │   ├── SignIn.jsx
│   │   │   └── TimerPage.jsx
│   │   ├── routes/                   # App-level routing
│   │   │   └── AppRoutes.jsx
│   │   ├── services/                 # Service layer (API/network helpers)
│   │   │   ├── AISummaryService.js
│   │   │   ├── bookService.js
│   │   │   └── tokenRefresher.js
│   │   ├── utils/                    # Utility/helper functions
│   │   │   └── filterPreferences.js
│   │   ├── App.css                   # Global app CSS
│   │   ├── App.jsx                   # Entry React component
│   │   ├── index.css                 # Additional global CSS
│   │   └── main.jsx                  # React/Vite bootstrap entry
│   ├── .env.example                  # Example env vars for frontend
│   ├── .gitignore                    # Frontend ignore rules
│   ├── .nmrc
│   ├── eslint.config.js              # ESLint config (frontend)
│   ├── index.html                    # Vite HTML template
│   ├── package-lock.json
│   ├── package.json
│   ├── README.md
│   ├── SETUP.md                      # Frontend setup instructions
│   ├── tailwind.config.js            # Tailwind CSS config
│   ├── vercel.json                   # Vercel deployment config
│   └── vite.config.js                # Vite build config
├── pr_artifacts/                     # Artifacts related to pull requests
│   └── (pr_#116/)
├── .gitignore                        # Top-level ignore rules
├── API_KEY_SETUP_GUIDE.md            # API key setup instructions
├── CODE_OF_CONDUCT.md                # Community code of conduct
├── CONTRIBUTING.md                   # Contributing guide
├── contributors.png                  # Contributor image/banner
├── LICENSE                           # Project license (MIT)
├── package-lock.json
├── package.json
├── README.md
├── SECURITY.md                       # Security policy/process
└── setup.sh                          # Project setup shell script

---

🤝 How to Contribute

Pouranik welcomes book lovers, devs, and designers!
Bug fixes, features, UI polish—you help us grow.

Start here:
Contribute to Pouranik →

---

🙌 Thank You, Contributors!

Thank you once again to all our contributors! Your efforts are truly appreciated. 💖👏

Maintainers

• Maintained with ❤️ by the Pouranik Core Team
  Lead: @bhaktimore18

---

Inspired By...

Every reader who ever felt seen in a story. Let's build this platform for curious minds across the world.

---

If you like this project, consider giving it a star and sharing it with friends!

⬆️ Back to Top