Environment:Infiniflow Ragflow Frontend Node Environment
| Knowledge Sources | |
|---|---|
| Domains | Frontend, Infrastructure |
| Last Updated | 2026-02-12 06:00 GMT |
Overview
Node.js 18.20.4+ frontend development environment with React, TypeScript, UmiJS, Ant Design, Zustand, and Tailwind CSS for the RAGFlow web application.
Description
This environment provides the frontend development stack for RAGFlow's web UI. It uses Node.js 18.20.4+ with npm as the package manager. The frontend is built with React and TypeScript using the UmiJS framework for routing and build tooling, Ant Design and shadcn/ui for UI components, Zustand for state management, and Tailwind CSS for styling. The production Docker image uses Node.js 20.x for building the frontend assets.
Usage
Use this environment for frontend development of the RAGFlow web application. Required for running the development server, building production assets, running ESLint, and executing Jest tests.
System Requirements
| Category | Requirement | Notes |
|---|---|---|
| OS | Any (Linux, macOS, Windows) | Cross-platform Node.js |
| Hardware | Standard development machine | No special requirements |
| Software | Node.js >= 18.20.4 | Docker uses Node.js 20.x for production builds |
Dependencies
System Packages
- `node` >= 18.20.4
- `npm` (bundled with Node.js)
Key NPM Packages
- `react` ^18.3.1
- `react-dom` ^18.3.1
- `umi` ^4.4.9 (UmiJS framework)
- `antd` ^5.22.3 (Ant Design UI)
- `zustand` ^5.0.2 (state management)
- `tailwindcss` ^3.4.15
- `@tanstack/react-query` ^5.62.3
- `i18next` ^24.2.2 (internationalization)
- `react-hook-form` ^7.54.2
- `typescript` ^5.7.2
- `vite` ^7.2.7 (build tool)
- `jest` ^29.7.0 (testing)
Credentials
No additional credentials required for frontend development. The frontend communicates with the backend API server.
Quick Install
cd web
npm install
npm run dev # Development server
npm run build # Production build
npm run lint # ESLint
npm run test # Jest tests
Code Evidence
Node.js engine requirement from `web/package.json:191-193`:
"engines": {
"node": ">=18.20.4"
}
Production build in Docker from `Dockerfile:88`:
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
Common Errors
| Error Message | Cause | Solution |
|---|---|---|
| `engine "node" is incompatible` | Node.js version < 18.20.4 | Upgrade Node.js to 18.20.4+ (use nvm) |
| `npm ERR! ERESOLVE` | Dependency resolution conflict | Run `npm install --legacy-peer-deps` |
| `Module not found` errors | Dependencies not installed | Run `npm install` in the `web/` directory |
Compatibility Notes
- Node.js 20.x: Used in production Docker builds. Recommended for local development.
- Node.js 24.x: Used in agent sandbox (separate isolated environment).
- npm: Required package manager. Yarn/pnpm not officially supported.