Developer overview
How the project is built.
Applivo is a Next.js frontend, a FastAPI backend, PostgreSQL, Redis with Celery for background work, and a Manifest V3 Chrome extension.
Applivo system architecture diagram
public/docs/images/docs-developer-architecture.png
| Layer | Technology |
|---|---|
| Frontend | Next.js (App Router), React, TailwindCSS, TypeScript |
| Backend | FastAPI, SQLAlchemy (async), Alembic, Pydantic |
| Data and queue | PostgreSQL, Redis, Celery |
| Extension | Chrome Manifest V3, plain JavaScript |
Longer notes live in the repository under docs/architecture and docs/development.
In this section
Local development setup
Run the whole stack with Docker.
Project structure
Where things live.
Environment configuration
Where settings come from.
Backend overview
The FastAPI service.
Frontend overview
The Next.js app.
Authentication and authorization
How requests are authenticated.
API reference
Route groups. The OpenAPI page is the complete reference.
Background jobs and queues
Celery, Redis and the scheduler.
Database and migrations
PostgreSQL and Alembic.
Testing
How to run the tests.
Troubleshooting development setup
Common local problems.