RainaCorp Innovation Lab

Project North Star

Self-Hosted Book Library Server

Production Ready - Fully Functional
Our Vision

Navigating Knowledge

Project North Star empowers individuals and organizations to own their digital library. A self-hosted solution inspired by Plex, designed for managing and reading EPUB and PDF books across your network. No cloud dependencies, no subscriptions - just pure, accessible knowledge.

Capabilities

State-of-the-Art Features

A comprehensive suite of tools for modern digital library management

📚

Smart Library Management

Automatic metadata extraction, cover images, and thumbnails. Support for EPUB and PDF formats with intelligent scanning and import capabilities.

🔍

Advanced Search & Filtering

Search across titles, authors, and descriptions. Filter by format, author, and series. Sort by title, author, or date added for instant discovery.

📖

Immersive EPUB Reader

Interactive reading experience with progress tracking, font size adjustment, multiple navigation methods, and chapter titles. Pick up where you left off, anywhere.

📄

Full-Featured PDF Viewer

Complete PDF rendering with page navigation, zoom controls, thumbnail navigation, and full-screen support. Progress tracking by page number.

🔐

Secure Authentication

JWT-based authentication system with user management. Secure, stateless sessions ensuring your library remains private and protected.

📱

Mobile Responsive

Fully responsive design that works seamlessly across all devices. Read your books on desktop, tablet, or mobile with consistent experience.

Technology

Built with Modern Stack

Leveraging cutting-edge technologies for performance and reliability

Backend Architecture

  • Node.js 20 + TypeScript
  • Express.js REST API
  • PostgreSQL 16+
  • JWT Authentication
  • Worker Service (Scanning)
  • Sharp (Image Processing)

Frontend Framework

  • React 18
  • Vite (Build Tool)
  • TypeScript
  • TailwindCSS
  • React Router
  • epub.js & pdf.js
User Interface

Experience the Interface

A modern, intuitive design built for readers and book lovers

Secure Authentication

Clean login interface with JWT-based authentication to protect your personal library

North Star Login Screen

Personalized Dashboard

Continue where you left off and discover recently added books to your library

North Star Homepage Dashboard

Comprehensive Library View

Browse your entire collection with advanced search, filters, and sorting capabilities

North Star Library View
Development Journey

Project Roadmap

From concept to production-ready solution

✓ Completed

Backend Infrastructure (100%)

PostgreSQL database with full schema, REST API server with JWT authentication, worker service for scanning and metadata extraction, automatic metadata enrichment, and reading progress tracking.

✓ Completed

Frontend Application (100%)

Login and authentication flow, home page with Continue Reading & Recently Added, library view with search and filters, EPUB/PDF readers with progress tracking, and admin panel for system management.

✓ Completed

Core Features Integration

Book scanning and import, automatic metadata extraction, author and series management, reading progress sync across devices, cover image extraction, and mobile-responsive design.

✓ Production Ready

Testing & Deployment

Comprehensive testing, Docker deployment support, documentation, and API endpoint validation. The system is now fully functional and ready for production use.

Get Started

Deploy Your Own Library

Take control of your digital reading experience with Project North Star

View on GitHub → Explore More Projects