roof/pic

Files

T

roof 0afdee32da feat: Services UI — nested nav, per-service pages, settings migration

Rename Store → Services: ServicesIndex.jsx shows built-in core services
(Email, Calendar, Files) with Manage links, plus the existing add-on
store below.

New service sub-pages at /services/email|calendar|files serve both
admin and peer roles. Admins see connection info, service status, users
list, and an inline config form (port/data-dir). Peers see connection
info and their personal credentials fetched from peerAPI.

Navigation restructured: a Services parent item expands to show the
three sub-pages via a collapsible sidebar group (ChevronDown toggle).
Both admin and peer navigation include the Services group. Sidebar
extracted NavItem/NavList components to eliminate the duplicate mobile/
desktop rendering.

Settings.jsx drops EmailForm, CalendarForm, FilesForm and their
SERVICE_DEFS entries. Port conflict detection and per-service validation
logic extracted to utils/serviceConfig.js, shared by Settings and the
new service pages. Service form flushers are registered without cleanup
so the Apply banner saves dirty config even when the user navigates away
from a service page before clicking Apply.

Legacy routes /email, /calendar, /files, /store redirect to their new
canonical paths.

GET /api/config now includes installed_services so the nav can derive
which add-ons are installed without a separate store fetch.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-28 06:46:17 -04:00

public

init

2025-09-12 23:04:52 +03:00

src

feat: Services UI — nested nav, per-service pages, settings migration

2026-05-28 06:46:17 -04:00

.gitignore

init

2025-09-12 23:04:52 +03:00

Dockerfile

wip: Fix ContainerDashboard

2025-09-13 15:49:32 +03:00

eslint.config.js

init

2025-09-12 23:04:52 +03:00

index.html

wip: peers

2025-09-13 18:56:00 +03:00

nginx.conf

feat: external IP detection, port status, fix peer config generation

2026-04-20 02:41:50 -04:00

package-lock.json

chore: add webui package-lock.json

2026-05-01 23:25:27 -04:00

package.json

feat(webui): internet sharing UI — exit-offer toggle + peer route-via selector

2026-05-01 23:07:50 -04:00

postcss.config.js

init

2025-09-12 23:04:52 +03:00

README.md

wip: make work Services Status

2025-09-13 14:23:31 +03:00

tailwind.config.js

init

2025-09-12 23:04:52 +03:00

vite.config.js

feat(webui): internet sharing UI — exit-offer toggle + peer route-via selector

2026-05-01 23:07:50 -04:00

README.md

Personal Internet Cell - Web UI

A modern React-based web interface for managing your Personal Internet Cell.

Features

Dashboard: Overview of cell status and services
Peer Management: Add, remove, and configure WireGuard peers
Network Services: DNS, DHCP, and NTP management
WireGuard: VPN configuration and status
Email Services: Postfix and Dovecot management
Calendar Services: Radicale CalDAV/CardDAV management
File Storage: WebDAV file storage management
Routing: Advanced VPN gateway and routing configuration
Logs: System logs and monitoring
Settings: Cell configuration and security settings

Tech Stack

React 19: Modern React with hooks
Vite: Fast build tool and dev server
Tailwind CSS: Utility-first CSS framework
Lucide React: Beautiful icons
React Router: Client-side routing
Axios: HTTP client for API communication

Development

Prerequisites

Node.js 18+ and npm
Personal Internet Cell backend running on port 3000

Setup

Install dependencies:
```
bun install
```
Start the development server:
```
npm run dev
```
Open your browser to http://localhost:5173

Development Features

Hot Reload: Changes reflect immediately
API Proxy: Requests to /api/* are proxied to http://localhost:3000
TypeScript Support: Full TypeScript support available
ESLint: Code linting and formatting

Building for Production

Build

npm run build

This creates a dist/ directory with optimized production files.

Preview

npm run preview

This serves the built files locally for testing.

API Integration

The Web UI communicates with the Personal Internet Cell backend API:

Base URL: http://localhost:3000 (development)
Health Check: /health
API Endpoints: /api/*

Environment Variables

Create a .env file to customize the API URL:

VITE_API_URL=http://localhost:3000

Project Structure

src/
├── components/          # Reusable UI components
│   └── Sidebar.jsx     # Navigation sidebar
├── pages/              # Page components
│   ├── Dashboard.jsx   # Main dashboard
│   ├── Peers.jsx       # Peer management
│   ├── NetworkServices.jsx
│   ├── WireGuard.jsx   # VPN configuration
│   ├── Email.jsx       # Email services
│   ├── Calendar.jsx    # Calendar services
│   ├── Files.jsx       # File storage
│   ├── Routing.jsx     # Routing configuration
│   ├── Logs.jsx        # System logs
│   └── Settings.jsx    # Cell settings
├── services/           # API services
│   └── api.js         # API client and endpoints
├── App.jsx            # Main app component
├── main.jsx           # App entry point
└── index.css          # Global styles

Styling

The Web UI uses Tailwind CSS with custom components:

Cards: .card for content containers
Buttons: .btn, .btn-primary, .btn-secondary, etc.
Inputs: .input for form fields
Status Indicators: .status-indicator, .status-online, etc.

Browser Support

Chrome 90+
Firefox 88+
Safari 14+
Edge 90+

Contributing

Follow the existing code style
Use TypeScript for new components
Add tests for new features
Update documentation as needed

License

Part of the Personal Internet Cell project.