Skip to content

ADR-0001 — Tech Stack
Status Accepted
Date 2025
Deciders Flooris development team

Context

A foundational technology stack is required for the Zwerfkei e-commerce platform. The stack must support a modern, maintainable web application with a clear separation between back-end business logic and front-end presentation. It must also run consistently across local development, test, acceptance and production environments.

Decision

The following technology stack is adopted:

Technology Role
MySQL Relational database for all persistent data.
Laravel (PHP) Application framework providing routing, ORM (Eloquent), queues, events and API layer.
Technology Role
VueJS Reactive front-end framework for interactive UI components.
TypeScript Typed superset of JavaScript for maintainability and tooling support.
Tailwind CSS Utility-first CSS framework for consistent, scalable styling.
Technology Role
Docker Containerised local development environment, ensuring consistency across developer machines.

Rationale

  • Laravel is the existing framework of choice within Flooris, with established patterns, in-house expertise and a rich ecosystem.
  • MySQL is a proven, widely supported relational database that integrates well with Laravel via Eloquent.
  • VueJS pairs naturally with Laravel (via Inertia.js or API-based integration) and is familiar to the front-end team.
  • TypeScript reduces runtime errors and improves developer experience for larger front-end codebases.
  • Tailwind CSS accelerates UI development while keeping stylesheets maintainable.
  • Docker eliminates environment inconsistencies and simplifies onboarding of new developers.

Consequences

  • All developers require a working Docker environment for local development.
  • PHP and Node.js version management is handled through the Docker configuration.
  • The stack aligns with existing Flooris projects, enabling knowledge sharing and reuse.