Deret Solver is an intelligent number sequence solver that combines local pattern detection with AI-powered analysis. It helps users identify, visualize, and understand various types of number sequences including arithmetic, geometric, Fibonacci, interleaved patterns, and more complex logic-based sequences.
Deret Solver uses a dual-solver approach to handle both simple and complex number sequences:
- Local Solver: Fast, offline detection of common patterns (arithmetic, geometric, Fibonacci, primes, factorials, etc.).
- Gemini AI Solver: AI-powered analysis for complex, abstract, and logic-based sequences using Google's Gemini API (
gemini-2.5-flash).
Built with React 19 and Vite 7 for cutting-edge performance and developer experience.
- Dual Solver System:
- Local Solver: Instantly solves Arithmetic, Geometric, Fibonacci, Two-Level Difference, Power, Prime Numbers, Factorials, and Interleaved Sequences.
- Gemini AI Solver: Handles complex and logic-based sequences with AI assistance.
- Quiz Mode: Test your skills! Generate sequence questions, choose the right answer, and track your progress.
- Dark Mode Support: Full theme switching with system preference detection and state persistence.
- Internationalization (i18n): Full support for English and Indonesian languages.
- Advanced Visualization:
- Dynamic SVG-based visualization with arcs for interleaved sequences and straight connections for standard patterns.
- Interactive nodes representing sequence elements and their logical connections.
- Responsive Design: Modern, glassmorphic UI built with Tailwind CSS v4.
- Privacy First: Local analysis when possible, with optional AI processing and secure API handling.
- Framework: React 19
- Build Tool: Vite 7
- Styling: Tailwind CSS v4
- Icons: Lucide React & Material Symbols
- AI Engine: Google Gemini AI API
- State/Routing: React Context, React Router 7
- Localization: i18next
- Backend/Hosting: Firebase (Hosting, Analytics)
The project maintains high standards with a comprehensive testing suite:
- Unit Testing: Vitest for logic and component testing.
- E2E Testing: Playwright for full-flow browser testing.
- Linting: Oxlint for high-performance linting.
- Formatting: Prettier.
# Run development server
npm run dev
# Run unit tests
npm test
# Run E2E tests
npm run test:e2e
# Generate E2E coverage report
npm run coverage:e2e
# Build for production
npm run buildIncludes a custom logger utility and Firebase Analytics integration to monitor application health and solver performance while respecting user privacy.
This project is licensed under the MIT License - see the LICENSE file for details.
