thelia/thelia

What is it?

Key features

• 01Built on Symfony 7.4 LTS and API Platform 4.3 for REST-style API access
• 02Twig-based front office (Flexy theme) and back office (default-twig theme)
• 03Propel ORM with MariaDB or MySQL support
• 04JWT-based API authentication via Lexik JWT
• 05Modular extension system with modules distributed separately

Use cases

• Building a custom online store on a PHP and Symfony stack
• Developing modules or themes for the Thelia e-commerce platform
• Running a self-hosted shop with a managed admin back office

Quick start

1. 1

   Configure the DDEV project with PHP 8.3, MariaDB 10.11 and Node.js 20

   ddev config --project-type=php --php-version=8.3 --database=mariadb:10.11 --docroot=public --nodejs-version=20
2. 2

   Start the DDEV environment

   ddev start
3. 3

   Install the Composer dependencies

   ddev exec composer install
4. 4

   Install Thelia with the demo data and an admin account

   ddev exec bin/install --frontoffice_theme=flexy --backoffice_theme=default-twig --pdf_theme=default --email_theme=default --with-demo --with-admin --admin_login=thelia --admin_password=thelia --admin_first_name=Admin --admin_last_name=User --admin_email=admin@example.com

Things to know

• !This repository is for developing Thelia itself; to build a shop, the README points to the separate thelia-project skeleton.
• !It requires PHP 8.3 or later, a MariaDB or MySQL database, and several PHP extensions.
• !Licensed under GPL-3.0, a copyleft license that applies to derivative works.

In collections

Topics

FAQ

What is thelia?

Open-source e-commerce framework and CMS for building online stores, built on Symfony 7 and API Platform. Thelia is an open source framework for building online stores and managing web content. Version 3 is written in PHP 8.3 to 8.5 and runs on Symfony 7.4 LTS with API Platform 4.3 in standalone mode, using Propel as its ORM and MariaDB or MySQL as the database.

Is thelia free to use? What license does it have?

thelia is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.

Is thelia still maintained?

Actively maintained. The last commit to thelia was on Nov 6, 2026.

What can I use thelia for?

Building a custom online store on a PHP and Symfony stack Developing modules or themes for the Thelia e-commerce platform Running a self-hosted shop with a managed admin back office

How do I install thelia?

Configure the DDEV project with PHP 8.3, MariaDB 10.11 and Node.js 20: ddev config --project-type=php --php-version=8.3 --database=mariadb:10.11 --docroot=public --nodejs-version=20 Start the DDEV environment: ddev start Install the Composer dependencies: ddev exec composer install Install Thelia with the demo data and an admin account: ddev exec bin/install --frontoffice_theme=flexy --backoffice_theme=default-twig --pdf_theme=default --email_theme=default --with-demo --with-admin --admin_login=thelia --admin_password=thelia --admin_first_name=Admin --admin_last_name=User --admin_email=admin@example.com

Where can I get thelia?

The source code and installation instructions are on GitHub: https://github.com/thelia/thelia