living.space

A small FastAPI + SQLite + React app for planning furniture and household purchases while moving into a new flat.

Features

• Rooms with descriptions, color palettes, reference images, and actual space images.
• Items grouped by room, with localized names/descriptions, prices, dates, amounts, images, palettes, and requirements.
• Offers for items or standalone offers, including links, images, delivery dates, quantity-aware pricing, and requirement checks.
• Chosen offers replace the abstract item in item lists while the original item details remain accessible.
• English/German UI, light/dark mode, and a local guest identifier stored in the browser.
• Hidden admin mode: tap the living.space logo five times quickly.

Admin mode is intentionally lightweight and hidden rather than secure. This matches the no-login requirement and is suitable for a trusted personal deployment, not a hostile public internet deployment.

Run With Docker

docker compose up --build

Then open:

• Frontend: http://localhost:5173
• Backend API: http://localhost:8000/docs

SQLite data is stored in the Docker volume living_space_data.

Local Development

Backend:

cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload

Frontend:

cd frontend
npm install
npm run dev

The frontend dev server proxies /api to http://localhost:8000.

Notes

• Images are stored as URLs for this first iteration. Upload/storage can be added later without changing the core data model much.
• Guests can add offers and edit or delete offers created from the same browser.
• Admins can create, edit, and remove rooms/items and choose offers.