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.woffandGeistVF.woffshould be placed inapp/fonts/
git clone https://github.com/one-Alive/readwise.git
cd readwisenpm installCreate a .env.local file in the root directory for clerk api
npm run devOpen http://localhost:3000 in your browser.
/auth/sign-up/auth/sign-in
welcome.tsx– Welcome screeninterests.tsx– Select interestsrecommendation.tsx– Preview personalized recommendationsfinal.tsx– Finalize and save preferences
-
Trending:
/discover -
Search:
/search -
Book Details:
/details/[id]- Includes:
BookMetadataCard,SampleReviewCard, andComments
- Includes:
- Create threads:
/create-thread - View threads and engage:
/thread/[id] - Rate books using the
Ratingcomponent
- 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.pngonboarding.pngbook-details.pngrecommendations.pngprofile.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 servernpm run build– Build for productionnpm 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/react@18.2.0/umd/react.production.min.js - ReactDOM:
https://cdn.jsdelivr.net/npm/react-dom@18.2.0/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 buildThis project is licensed under the MIT License.
Questions or feedback? Reach out to @oneAlive or open an issue.