ReadingStar Planet is a Next.js reading support app designed for children who benefit from structured, low-friction reading assistance. It combines reading focus tools, text-to-speech support, document management, and role-based administration in a single web app.
- Guided reading modes with adjustable font size, line spacing, masking, and themed focus views
- Text-to-speech support with voice preview and reading companion controls
- PDF, TXT, and pasted-text import flows with preview and editing before saving
- Library management with document grouping, search, sorting, editing, and reading history
- Role-aware account management, profile editing, and admin-only global defaults
- English and Chinese UI support, plus PWA support for an app-like experience
An inviting entry point into the ReadingStar planet adventure.
Keep the paragraph focused by highlighting a chosen character.
Practice spotting letters that are easy to confuse.
- Next.js App Router
- React + TypeScript
- Tailwind CSS
- SQLite via better-sqlite3
- Vitest and Playwright for testing
- Node.js 22+
- npm
npm installnpm run devOpen http://localhost:3000.
npm run build
npm startnpm testFor end-to-end coverage:
npm run test:e2e- Google sign-in is optional and requires local environment variables such as
GOOGLE_CLIENT_ID,GOOGLE_CLIENT_SECRET, andGOOGLE_REDIRECT_URI. - The SQLite database is created locally under
data/by default, or you can override the location withREADINGSTAR_DB_PATH. - You can seed an initial admin account with
INITIAL_ADMIN_EMAIL.
This project is licensed under the MIT License. See the LICENSE file for details.


