https://github.com/falconandrea/start-laravel-project

Config and tricks for init new laravel project
https://github.com/falconandrea/start-laravel-project

configuration laravel starter

Last synced: 18 days ago
JSON representation

Config and tricks for init new laravel project

• Host: GitHub
• URL: https://github.com/falconandrea/start-laravel-project
• Owner: falconandrea
• Created: 2021-06-30T17:23:57.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2021-10-29T09:17:29.000Z (over 3 years ago)
• Last Synced: 2024-11-24T19:14:58.170Z (3 months ago)
• Topics: configuration, laravel, starter
• Homepage:
• Size: 10.7 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# First config and tricks for new Laravel project



## Requirements

-   Laravel

-   Composer

-   Docker

-   Sail

## Initial

### Update file .env

Not use Root as user.

```

APP_NAME="Laravel Project"

APP_URL="http://laravel-project.test"

DB_USERNAME="laravel"

DB_PASSWORD="laravel"

```

### Sail Installation (only for first start)

```

composer require laravel/sail --dev

```

and add alias into your bash/zsh file

```

alias sail='bash vendor/bin/sail'

```

add docker-compose.yml, update .env vars with docker vars

```

php artisan sail:install

```

start docker containers

```

sail up -d

```

and add APP_KEY in .env with

```

sail artisan key:generate

```

connect storage folder

```

sail artisan storage:link

```

### Start up (after first installation)

```

sail up -d

```

Update database with new migrations

```

sail artisan migrate

```

## Notes

-   After update docker-compose.yml, rebuild docker containers with

```

sail build --no-cache

sail up

```

-   When you use Sail, the commands npm, artisan and composer MUST be used with sail command.

## Telescope (for local development)

Follow the guide here: [Laravel Tescope Install guide](https://laravel.com/docs/8.x/telescope#local-only-installation)

For Dashboard Authorization, update the function with this check

```

protected function gate()

{

    Gate::define('viewTelescope', function ($user) {

        return $this->app->environment('local');

    });

}

```

## Ui Tailwind CSS

View on [Git](https://github.com/laravel-frontend-presets/tailwindcss)

```

composer require laravel-frontend-presets/tailwindcss --dev

php artisan ui tailwindcss --auth

npm install && npm run dev

```

### Notes

If you get error `sh: mix: command not found`

```

npm install laravel-mix@latest

```

## For create secondary database for test

Create file `.env.testing` duplicated from `.env` and change only this row:

```

DB_HOST=mysql_test

```

Update `docker-compose.yml` with this rows

```

mysql_test:

    image: "mysql:8.0"

    environment:

        MYSQL_ROOT_PASSWORD: "${DB_PASSWORD}"

        MYSQL_DATABASE: "${DB_DATABASE}"

        MYSQL_USER: "${DB_USERNAME}"

        MYSQL_PASSWORD: "${DB_PASSWORD}"

        MYSQL_ALLOW_EMPTY_PASSWORD: "yes"

    networks:

        - sail

```

And use command `sail test` for run the test

## License

The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).