Readwise is a Next.js (React) web application developed as part of the research project:

"Accelerating Book Recommendations: Real-Time Personalization on Social Review Platforms with FAISS and LDA"

It enables users to discover, review, and discuss books through real-time, personalized recommendations powered by FAISS and LDA.

• ⚡ Real-Time Recommendations: Sub-50ms latency using FAISS and topic modeling (LDA).
• 🧭 User Onboarding: Multi-step flow to initialize reading preferences.
• 💬 Social Interactions: Thread creation, comments, and ratings on books.
• 🔍 Book Discovery: Search, trending books, metadata, and reviews.
• 👤 User Profiles: View personal threads and recommendation history.
• 💳 Purchase / Rental System: Rent or buy books directly within the app.
• 🌙 Responsive UI: Built with Tailwind CSS, dark/light theme switcher, and Geist fonts.

• Node.js: v18.x or higher
• npm: For dependency management
• Backend API: e.g., https://x.ai/api
• Fonts: GeistMonoVF.woff and GeistVF.woff should be placed in app/fonts/

git clone https://github.com/one-Alive/readwise.git
cd readwise

npm install

Create a .env.local file in the root directory for clerk api

npm run dev

Open http://localhost:3000 in your browser.

• /auth/sign-up
• /auth/sign-in

1. welcome.tsx – Welcome screen
2. interests.tsx – Select interests
3. recommendation.tsx – Preview personalized recommendations
4. final.tsx – Finalize and save preferences

• Trending: /discover

• Search: /search

• Book Details: /details/[id]

  • Includes: BookMetadataCard, SampleReviewCard, and Comments

• Create threads: /create-thread
• View threads and engage: /thread/[id]
• Rate books using the Rating component

• View user activity: /profile/[id]
• Explore personal threads via ThreadsTab

• Rent: /rentals/[id]/[user_id]
• Buy: /purchase/[id]/[user_id]

Located in the ss/ folder:

• homepage.png
• onboarding.png
• book-details.png
• recommendations.png
• profile.png

readwise/
├── app/
│   ├── (auth)/
│   │   ├── onboarding/
│   │   ├── sign-in/
│   │   └── sign-up/
│   ├── (root)/
│   │   ├── create-thread/
│   │   ├── details/[id]/
│   │   ├── discover/
│   │   ├── profile/[id]/
│   │   ├── purchase/[id]/[user_id]/
│   │   ├── rentals/[id]/[user_id]/
│   │   ├── search/
│   │   └── thread/[id]/
│   ├── fonts/
│   └── ThemeProvider.tsx
├── components/
│   ├── cards/
│   ├── forms/
│   ├── onboarding/
│   ├── shared/
│   └── ui/
├── lib/
│   ├── actions/
│   ├── validations/
│   └── utils.ts
├── public/
├── ss/
├── .env.local
├── next.config.mjs
├── tailwind.config.ts
├── tsconfig.json
└── README.md

• npm run dev – Start development server
• npm run build – Build for production
• npm run start – Launch production build

• Next.js – App Router, SSR, SSG
• React + TypeScript – Component-driven development
• Tailwind CSS – Utility-first styling
• Axios – For API communication
• Geist Fonts – Custom font system

• React: https://cdn.jsdelivr.net/npm/[email protected]/umd/react.production.min.js
• ReactDOM: https://cdn.jsdelivr.net/npm/[email protected]/umd/react-dom.production.min.js

Endpoint:

Example Request:

{
  "user_id": "user_1",
  "liked_book_ids": ["1001", "1002"],
  "preferred_author_ids": ["author_1"],
  "user_interests": ["science", "fiction"],
  "top_n": 5
}

Example Response:

[
  {
    "book_id": "1003",
    "title": "Science Book A",
    "similarity": 0.95
  }
]

This repository contains only the frontend. The Flask-based backend, including FAISS, LDA, and recommendation logic, will be released separately.

npm run build

This project is licensed under the MIT License.

Questions or feedback? Reach out to @oneAlive or open an issue.