cakephp/app-tailwind

CakePHP skeleton Tailwind app

5.x-dev 2025-06-29 07:44 UTC

Requires

• php: >=8.1
• cakephp/cakephp: 5.2.*
• cakephp/migrations: ^4.0.0
• cakephp/plugin-installer: ^2.0
• mobiledetect/mobiledetectlib: ^4.8.03

Requires (Dev)

• cakephp/bake: ^3.0.0
• cakephp/cakephp-codesniffer: ^5.0
• cakephp/debug_kit: ^5.0.0
• josegonzalez/dotenv: ^4.0
• phpunit/phpunit: ^10.5.5 || ^11.1.3 || ^12.1

Suggests

• cakephp/repl: Console tools for a REPL interface for CakePHP applications.
• dereuromark/cakephp-ide-helper: After baking your code, this keeps your annotations in sync with the code evolving from there on for maximum IDE and PHPStan/Psalm compatibility.
• markstory/asset_compress: An asset compression plugin which provides file concatenation and a flexible filter system for preprocessing and minification.
• phpstan/phpstan: PHPStan focuses on finding errors in your code without actually running it. It catches whole classes of bugs even before you write tests for the code.

MIT

README

An application skeleton for creating applications with CakePHP 5.x. and tailwind

The framework source code can be found here: cakephp/cakephp.

Installation

1. Download Composer or update composer self-update.
2. Run php composer.phar create-project --prefer-dist cakephp/app-tailwind [app_name].

If Composer is installed globally, run

composer create-project --prefer-dist cakephp/app-tailwind myapp

Next, install tailwind and vite with npm:

npm install

Running a development server

You can run both a PHP development server, and tailwind with on-demand rebuilds using:

bin/cake devserver

Then visit http://localhost:8765 to see the welcome page. If you already have a webserver that supports PHP, you can run the tailwind compiler on its own with:

npm run dev

Building for production

To build CSS assets for production, use:

npm run build

Bake templates

This application skeleton contains a bake templates and helper templates that produce HTML using tailwind utility classes. You can and should adapt these templates to fit the needs of your application.

Update

Since this skeleton is a starting point for your application and various files would have been modified as per your needs, there isn't a way to provide automated upgrades, so you have to do any updates manually.

Configuration

Read and edit the environment specific config/app_local.php and set up the 'Datasources' and any other configuration relevant for your application. Other environment agnostic settings can be changed in config/app.php.