https://github.com/cakephp/app-tailwind
https://github.com/cakephp/app-tailwind
Last synced: 7 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/cakephp/app-tailwind
- Owner: cakephp
- License: mit
- Created: 2025-04-14T02:23:50.000Z (10 months ago)
- Default Branch: 5.x
- Last Pushed: 2025-06-17T21:24:05.000Z (7 months ago)
- Last Synced: 2025-06-17T22:29:47.006Z (7 months ago)
- Language: PHP
- Size: 431 KB
- Stars: 0
- Watchers: 11
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CakePHP Application Skeleton
[](https://github.com/phpstan/phpstan)
An application skeleton for creating applications with [CakePHP](https://cakephp.org) 5.x. and [tailwind](https://tailwindcss.com)
The framework source code can be found here: [cakephp/cakephp](https://github.com/cakephp/cakephp).
## Installation
1. Download [Composer](https://getcomposer.org/doc/00-intro.md) 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
```bash
composer create-project --prefer-dist cakephp/app-tailwind myapp
```
Next, install [tailwind](https://tailwindcss.com/docs) and [vite](https://vite.dev/guide/)
with npm:
```bash
npm install
```
## Running a development server
You can run both a PHP development server, and tailwind with on-demand rebuilds using:
```bash
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:
```bash
npm run dev
```
## Building for production
To build CSS assets for production, use:
```bash
npm run build
```
## Bake templates
This application skeleton contains a [bake
templates](https://book.cakephp.org/bake/3/en/development.html#application-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`.