# NewBI

**Repository Path**: saugage/new-bi

## Basic Information

- **Project Name**: NewBI
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-21
- **Last Updated**: 2026-11-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NewBI Project

## Ports

- Frontend default port: `11001`
- Backend default port: `11002`

Use `frontend.env.example` when creating the frontend app:

```bash
VITE_DEV_PORT=11001
VITE_API_BASE_URL=http://127.0.0.1:11002
```

## Project Scripts

```bash
node scripts/start.mjs
node scripts/stop.mjs
node scripts/restart.mjs
```

The scripts write PID files and logs to `run/`.

Environment overrides:

```bash
FRONTEND_PORT=11001 BACKEND_PORT=11002 JWT_SECRET=your-secret node scripts/start.mjs
```

If `JWT_SECRET` is not provided, the startup script uses a local development secret.

If `frontend/package.json` does not exist yet, the frontend startup step is skipped and the backend still starts.

## Frontend

The current frontend is a dependency-free static app in `frontend/`.

Implemented pages:

- Data sources: create, list, edit, delete, detail, TCP/API connectivity test
- System settings: UI style switching

Pages currently shown as "under construction" until real implementations are added:

- Dashboard
- Datasets
- Screens
- Screen designer
- Assets
- AI providers

The startup script writes `frontend/env.js` so the UI can call the backend API.

System settings includes three UI styles:

- Halo Light: light operational theme
- Noir Ops: dark monitoring theme
- Terra Warm: warm collaboration theme

The selected style is saved in the browser and restored on the next visit.