Architecture

This document provides an overview of the layout of the project and describes the general architecture for the application and it’s various services.

• Frontend
• Backend
• Configuration

Tech Stack

Here is a list of modules, packages, and frameworks used to build Tesy’s Tagboard. It’s not exhaustive, but points to some important documentation for hacking on the project.

• Django as the backbone web framework for the application

  • django-environ for handling environment variables using the Twelve-factor methodology

  • django-allauth for handling authentication flows via username, email, and third-party authentication

  • django-ninja for buliding and documenting the REST API

  • whitenoise for serving static files

• pytest for backend testing

• docker and docker-compose for development environment setup and production deployment

• HTMX for frontend interactivity and dynamic content loading

• Tailwind CSS styling

• DaisyUI Component library with semantic class naming on top of Tailwind

Configuration

TODO

Docker

The docker-compose files for dev, production, and the docs are available in the project root directory with the related build files available in ./compose/.