Nexus Workspace

A focused workspace for projects, tasks and team collaboration.

Overview

Nexus Workspace is a polished, local-first portfolio application for managing projects, tasks, schedules and team activity. It combines a FastAPI backend, server-rendered Jinja templates and a responsive interface with no frontend build step.

Features

• Secure password hashing and signed HttpOnly cookie sessions
• CSRF protection on every state-changing form
• Project creation, editing, filtering and deletion
• Drag-and-drop Kanban with persisted status changes
• Analytics charts, events calendar and team workload
• Profile and password settings, search and notifications
• Light/dark themes and accessible responsive navigation
• Deterministic demo data: 6 users, 6 projects, 30 tasks, 12 events, 20 activities and 8 notifications

Screenshots

Dashboard

Projects

Kanban board

More product screens

Sign in

Project details

Analytics

Calendar

Team

Mobile dashboard

Mobile Kanban

Tech Stack

Python 3.11+, FastAPI, Uvicorn, SQLAlchemy 2, SQLite, Pydantic Settings, Jinja2, pwdlib/Argon2, vanilla JavaScript, Chart.js and Lucide Icons.

Project Structure

app/ contains configuration, database models, security, seed data, routers, templates and static assets. tests/ contains isolated integration tests. scripts/ contains the optional demo seed command, while runtime data is written to ignored data/*.db files.

Quick Start

git clone <your-repository-url>
cd nexus-workspace
python -m venv .venv

Windows:

.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env
python run.py

Linux/macOS:

source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
python run.py

Open http://127.0.0.1:8000.

Demo Account

• Email: demo@nexus.local
• Password: demo12345

Environment Variables

Copy .env.example to .env. Change SECRET_KEY to a long random value for any shared environment. APP_ENV=production enables secure-only cookies; serve the application over HTTPS in that mode.

Running Tests

pytest

The suite uses a separate data/test_nexus.db and never modifies the main database.

Security

See SECURITY.md. The local defaults and demo credentials are not suitable for production.

Roadmap

• Project memberships and role-based permissions
• Recurring events and richer calendar views
• PostgreSQL migrations and audit exports
• Optional real-time collaboration

License

MIT © 2026 Nexus Workspace contributors.