---

Overview

LocalStack is a modern, full-stack Employee Management System built with FastAPI and React. Designed for small to medium-sized businesses, it provides a complete solution for managing employees, companies, tasks, and internal operations.

License Notice: This software is free for personal and educational use. Commercial use requires a license.

---

Features

Core Functionality

• Company Management - Create and manage your organization
• Employee Management - Add, edit, and manage team members with role-based access
• To-Do System - Task management with priorities, assignments, and archiving
• Role-Based Access Control - CEO, Manager, and Worker permission levels
• Avatar Upload - Profile picture management for all users
• Dark/Light Theme - Fully customizable UI themes
• Multi-Language Support - Internationalization ready

Technical Features

• JWT-based authentication with refresh tokens
• Responsive design for desktop and mobile
• Real-time UI updates with React Query
• Secure password hashing
• SQLite database with Alembic migrations

---

Tech Stack

Layer	Technology
Backend	FastAPI, SQLAlchemy, Alembic, Python 3.8+
Frontend	React 18, Vite, TailwindCSS, TanStack Query
Database	SQLite (production-ready, easy to migrate)
Authentication	JWT tokens with automatic refresh
Icons	Lucide React

---

Quick Start

Prerequisites

• Python 3.8 or higher
• Node.js 18 or higher
• Git

Backend Setup

cd backend

# Create virtual environment
python -m venv venv

# Activate (Windows)
venv\Scripts\activate
# Activate (Linux/Mac)
# source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run database migrations
alembic upgrade head

# Start development server
uvicorn app.main:app --reload --port 8000

Frontend Setup

cd frontend

# Install dependencies
npm install

# Start development server
npm run dev

The application will be available at http://localhost:5173 (frontend) and http://localhost:8000 (backend API).

---

API Documentation

Once the backend is running, interactive API documentation is available at:

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

Key Endpoints

Endpoint	Method	Description
/api/auth/register	POST	Register new CEO account
/api/auth/login	POST	User login
/api/auth/refresh	POST	Refresh access token
/api/auth/me	GET	Get current user info
/api/company	POST	Create company (CEO only)
/api/employees	GET/POST	List/add employees
/api/todos	GET/POST	Manage todos
/api/health	GET	Health check

---

Project Structure

LocalStack/
├── backend/                 # FastAPI backend
│   ├── app/
│   │   ├── auth.py         # Authentication logic
│   │   ├── database.py     # Database configuration
│   │   ├── main.py         # API endpoints
│   │   ├── models.py       # SQLAlchemy models
│   │   └── schemas.py      # Pydantic schemas
│   ├── alembic/            # Database migrations
│   └── requirements.txt
│
├── frontend/               # React frontend
│   ├── src/
│   │   ├── api/           # API client modules
│   │   ├── components/    # React components
│   │   ├── contexts/      # React contexts (theme, language)
│   │   ├── pages/         # Page components
│   │   └── App.jsx        # Main application
│   └── package.json
│
└── LICENSE                # Custom Non-Commercial License

---

Commercial Licensing

This software is free for personal, educational, and internal business use.

Commercial Use Requires License

The following activities require an explicit commercial license:

• Selling the software or derivative works
• Hosting as a paid SaaS service
• Including in commercial products
• Providing the software as part of consulting services

Contact for Licensing

Interested in commercial use? Contact the author:

Platform	Contact
Telegram	@M0x37
Discord	m0x37
Email	max@m0x2.de

---

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

All contributions are subject to the same license terms.

---

License

This project is licensed under a Custom Non-Commercial License.

• ✅ Free to download and use personally
• ✅ Free for educational purposes
• ✅ Free for internal business use
• ✅ Modifications must be shared alike
• ❌ No commercial sale or rental without permission
• ❌ No SaaS hosting for profit without license

See LICENSE for full terms.

---

Support

• 🐛 Bug Reports: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📧 Private Inquiries: max@m0x2.de

---

Made with ❤️ by M0x37

_{© 2026 Max Schüller. All Rights Reserved.}