An intelligent, full-stack digital reading platform that brings together real-time global news, an expansive e-book archive, autonomous AI-synthesized investigative news briefings, and an agentic research chatbot.
- Real-Time Coverage: Aggregated breaking news from trusted global publishers across technology, business, politics, health, science, sports, and entertainment.
- Regional & Categorical Filtering: Instant filtering by country (US, India, etc.) and category tags.
- Live News Ticker: Marquee ticker highlighting breaking headlines at a glance.
- Deep Reader View: Distraction-free article preview and reading mode.
- Curated Digital Library: Browse books across diverse genres including History, Science, Business, Health, Horror, and Children's literature.
- Category Filter & Search: Quick discovery with instant search and category tags.
- Interactive Reader: Clean in-browser e-book reader experience.
- Synthetic Journalism: Continuous, in-depth briefings researched and synthesized by autonomous AI news agents.
- Deep Context & Analysis: Detailed breakdown of complex trends across technology, global markets, and emerging science.
- Real-Time Activity Console: Live transparency into the agent's thoughts, strategy formation, tool calls, and execution steps.
- Source Auditor & Vault: Complete citation tracking with direct links to verified sources used during fact-checking and synthesis.
- Quick-Start Prompts: Contextual suggestion chips for top global headlines, 60-second briefings, market insights, and book recommendations.
- Ask AI: Select any news article to extract core entities, retrieve related contextual reports, and generate multi-perspective explanations.
- Future AI (Future Insight): Predictive logic engine that models potential downstream developments and simulates future headlines based on current events.
- User Authentication: Secure login, registration, and session management.
- Profile Customization: Customizable user profile with avatar selection.
- Dark / Light Theme: Seamless theme toggling with persistent preferences.
- Framework: Next.js 15 (App Router)
- Library: React 19
- Language: TypeScript
- Styling: Tailwind CSS v4, tw-animate-css
- UI Components: Radix UI, Lucide React icons, Sonner toasts, Vaul
- State Management: Zustand
- Markdown Rendering: react-markdown,
remark-gfm,rehype-raw,rehype-external-links - Data Fetching: SWR, Axios
- Deployment: Vercel
- Node.js 18.x or later
- npm, yarn, or pnpm
-
Clone the repository:
git clone https://github.com/Snaehath/readhub-frontend.git cd readhub-frontend -
Install dependencies:
npm install
-
Configure Environment Variables: Create a
.env.localfile in the root directory:BACKEND_API_URL=http://localhost:5000
The frontend proxies
/apirequests to this server. In production, setBACKEND_API_URL=https://readhub-backend.onrender.comin the frontend host's server-side environment. Configure the backend'sFRONTEND_ORIGINSwith the deployed frontend origin. -
Run the development server:
npm run dev
-
Open the app: Navigate to http://localhost:3000 in your browser.
npm run dev- Starts the Next.js development server.npm run build- Builds the application for production.npm run start- Runs the production server.npm run lint- Runs ESLint checks.npm run type-check- Runs TypeScript type validation.
ReadHub is deployed and accessible at:
👉 https://readhub-frontend.vercel.app