Implement new theme

[Muhammad-Nawlo]

aimeos/aimeos-laravel: 2025.04.*
aimeoscom/ai-sites: "^2025.04,
Hey,I bought an html template for an e-commerce and I want to implement it using aimeos.
My question is should I add new pages in templates and views folder in my extension
or overwrite the existing one.

Note: css and js file in themes folder should delete the old one and template's files
I want the best practice
Thank you.

[aimeos]

Using HTML/CSS/JS from a design that has a totally different structure is a pretty hard task in every project (also non-Aimeos related). The problem is that you have to integrate all PHP code from the Aimeos templates to the new HTML.

Furthermore, if you don't assign the same CSS classes to the new template, the existing Aimeos JS code won't work any more (even if you do, it's likely that not all JS code will be working). If you leave out the Aimeos JS code completely, some features won't work any more.

[Muhammad-Nawlo]

Hey, Thank you for replying.
So do you recommend to work with only css files with its classes to implemenet my new design (theme) to not lost the functionallity of js
or something else

[aimeos]

Yes, using adapted CSS files is the most efficient way to create a new Aimeos theme. At a few places, you will need to adapt the HTML as well but that's OK as long as you don't need to overwrite all templates.