Local Development#

Requirements#

• PHP >= 8.2
• ext-imagick
• puppeteer see Browsershot docs

Clone the repository#

git clone git@github.com:usetrmnl/larapaper.git

Copy environment file#

cp .env.example .env

Install dependencies and build frontend#

composer install
npm i
npm run build

Generate application key#

php artisan key:generate

Run migrations#

php artisan migrate --seed

Link storage to expose public assets#

php artisan storage:link

Run the server#

To expose the built-in server to the local network, you can run the following command:

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:

cp .env.example.local .env

Run migrations and seed the database:

php artisan migrate --seed

Link storage to expose public assets:

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#

composer install
npm i
npm run build