TallStackUI, Starter Kit

# About Starter Kit

The Starter Kit is a quick and easy way to begin a new Laravel project, containing everything essential for a basic Laravel project and including TallStackUI v4. Read the entire page to understand how to use the TallStackUI Starter Kit.

# Ready to Use

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

Laravel v13
Livewire v4
TallStackUI v4
TailwindCSS v4

Features:

Basic sqlite database connection
Login, registration, password reset, profile update, 2FA.
Users C.R.U.D. example
Dark theme switcher
Full test covered
All unnecessary comments removed

The new version of the Starter Kit now uses the Laravel Fortify instead of Laravel Breeze.

Tools and commands:

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

All in one:

composer run 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:
```
Test123!
```
* 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 Fortify. Keep in mind that all other aspects are modeled after the way Laravel Fortify 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.