TallStackUI, Starter Kit

# Preview

Have you ever imagined having a Laravel 12 project completely ready to use in exactly 30 secs? 🤯

The release of Laravel 12 brought the long-awaited support for community starter kits through the Laravel installer. The idea behind starter kits is to offer a ready-to-use base project containing customizations specific to each use case. The TallStackUI starter kit offers a simple project, yet fully prepared for real use. The biggest benefit of using the TallStackUI starter kit is saving time on basic setup of new Laravel projects.

# Ready to Use

Here is the list of everything the TallStackUI starter kit delivers out of the box:

Laravel 12
Livewire 3
TallStackUI 2
TailwindCSS v4

TallStackUI support both TailwindCSS versions, v3 and v4, but we have no plans to create a TallStackUI starter kit based on TailwindCSS v3 since the main version of TailwindCSS is now v4.

Features:

Basic sqlite database connection
Basic login and registration
Basic profile update page
Users C.R.U.D. example
Dark theme switcher
Full test covered
One single config file published
All unnecessary comments removed

Tools:

Pest:
```
composer test
```
PhpStan:
```
composer analyse
```
Pint:
```
composer format
```

You can also use the composer ci , like simulating a CI/CD pipeline:

composer ci

# How to Use

As mentioned above, the TallStackUI starter kit requires the use of the Laravel installer. If you want to use the TallStackUI starter kit without the Laravel installer you can clone the repository, and then delete the .git folder to do not track changes of the starter kit. In this way, you will need to install the starter kit manually, which may require more knowledge and time.

Start a new Laravel project using this command:
```
laravel new --using=tallstackui/starter-kit
```
After executing the above mentioned command, you can follow the normal Laravel installation process. You may be asked several questions, just pay attention and answer correctly

# First Usage

On first use you will notice that the welcome page is actually the default Laravel page. However, at the top of the page there will be buttons for login and registration. You can create a new account or use the default account, which has the following credentials:

Email:
```
[email protected]
```
Password:
```
password
```
* This password is intended to be used only locally.

# Basic CRUD

The TallStackUI starter kit includes a basic user C.R.U.D. that you can view by navigating to the /users page. The idea of this C.R.U.D. is just to provide a preview of a table structure for listing, creating, updating, and destroying users. Keep in mind that the authenticated user is not displayed in the user list.

Internally, the C.R.U.D. uses the App\Livewire\Users namespace structure dividing each C.R.U.D. action in a specific Livewire component for a better organization:

Users\Index - Used to only list the users and also display other components
Users\Create - Used to create new users, called inside Index
Users\Update - Used to update users, called inside Index
Users\Delete - Used to delete users, called inside Index

The Create , Update , and Delete are children of Index .

# Caveats

The starter kit uses a primary color based on the TallStackUI documentation color.
The starter kit is built on top of Laravel Breeze. Keep in mind that all other aspects are modeled after the way Laravel Breeze works.
Due to the way Laravel starter kit mechanism works, any updates we make to the TallStackUI starter kit will not be reflected in your project, but rather in new installations, because installation using starter kits is not based on tags, but on the base branch of the repository.
If you want to improve the starter kit in any way, please send us a pull request.