mirror of
https://github.com/usetrmnl/byos_laravel.git
synced 2026-01-13 23:18:10 +00:00
92 lines
1.5 KiB
Markdown
92 lines
1.5 KiB
Markdown
## Local Development
|
|
|
|
#### Requirements
|
|
|
|
* PHP >= 8.2
|
|
* ext-imagick
|
|
* puppeteer [see Browsershot docs](https://spatie.be/docs/browsershot/v4/requirements)
|
|
|
|
#### Clone the repository
|
|
|
|
```bash
|
|
git clone git@github.com:usetrmnl/byos_laravel.git
|
|
```
|
|
|
|
#### Copy environment file
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
#### Install dependencies and build frontend
|
|
|
|
```bash
|
|
composer install
|
|
npm i
|
|
npm run build
|
|
```
|
|
|
|
#### Generate application key
|
|
|
|
```bash
|
|
php artisan key:generate
|
|
```
|
|
|
|
#### Run migrations
|
|
|
|
```bash
|
|
php artisan migrate --seed
|
|
```
|
|
|
|
#### Link storage to expose public assets
|
|
|
|
```bash
|
|
php artisan storage:link
|
|
```
|
|
|
|
#### Run the server
|
|
|
|
To expose the built-in server to the local network, you can run the following command:
|
|
|
|
```bash
|
|
php artisan serve --host=0.0.0.0 --port 4567
|
|
```
|
|
|
|
---
|
|
|
|
## Docker
|
|
Use the provided Dockerfile, or docker-compose file to run the server in a container.
|
|
|
|
#### .devcontainer
|
|
|
|
Open this repository in Visual Studio Code with the Dev Containers extension installed. This will automatically build the devcontainer and start the server.
|
|
|
|
Copy the .env.example.local to .env:
|
|
|
|
```bash
|
|
cp .env.example.local .env
|
|
```
|
|
|
|
Run migrations and seed the database:
|
|
|
|
```bash
|
|
php artisan migrate --seed
|
|
```
|
|
|
|
Link storage to expose public assets:
|
|
|
|
```bash
|
|
php artisan storage:link
|
|
```
|
|
|
|
Server is ready. Visit tab "Ports" in VSCode and visit the "Forwarded Address" in your browser.
|
|
|
|
Login with user / password `admin@example.com` / `admin@example.com`
|
|
|
|
##### After Pull: Install Packages and Build Frontend
|
|
|
|
```bash
|
|
composer install
|
|
npm i
|
|
npm run build
|
|
```
|