A web based UI for browsing the projects being served by Laravel Valet.

Overview

🚀 Valet Launchpad

GitHub Tests Action Status

A web based UI for browsing the projects being served by Laravel Valet.

valet-launchpad

Built on Laravel (with TailwindCSS & Alpine.JS), this small web app will show all the projects being served by Laravel Valet, give you quick access to all the URLs it's served via (linked or parked) and will highlight if there is a match / mismatch with your current PHP version. It works great when configured as your default project in Laravel Valet (see below for instructions). It comes complete with a light and dark UI, matching your OS preference.

ℹ️ Requirements

  • You must be using Laravel Valet to serve projects in your local environment
  • Although Laravel Valet supports earlier versions, this application requires PHP >= 7.4
  • The user that PHP-FPM is running under must have access to the Laravel Valet binary (need help?) (we hope to remove this requirement in the future)

💾 Installation

Ensure the above requirements are met before installing. These installation instructions assume you have some familiarity with running commands in your local terminal, Laravel and Laravel Valet.

Clone the release branch of this repository into a directory:

git clone https://github.com/gbuckingham89/valet-launchpad.git --branch release --single-branch

From the newly created directory in your Terminal, install the dependencies:

composer install --no-dev

Create a .env file:

cp .env.example .env

Generate an application key:

php artisan key:generate

Ensure the directory is being served by Laravel Valet. If it's not already in a parked directory, you can run:

valet link

Finally, using your preferred editor, open the .env file and set the value of the APP_URL option as appropriate (e.g. APP_URL=http://valet-launchpad.test). You could also take this opportunity to customise the application name if you wish by editing the APP_NAME option.

You should now be able to visit that URL in your preferred web browser.

Set as default Valet site

Laravel Valet can be configured to serve a default site instead of a 404 error if you visit an unknown .test domain - that's a great use for this project!

Open your Laravel Valet config file (~/.config/valet/config.json) in your preferred editor.

If it doesn't already exist, add a default key, and ensure the value is set to the path of your gbuckingham89/valet-launchpad files. For example:

{
    "default": "/Users/JoeBloggs/Sites/valet-launchpad"
}

⚠️ Troubleshooting

Valet not installed

If you see errors about Valet not being installed (but you're sure that it is, and you see output by running which valet from your local terminal) it's likely that the user running PHP-FPM doesn't know where the Valet binary is located, or doesn't have permission to run it.

There are two ways to resolve this;

  1. Find the value of the PATH environment variable for your shell by running echo $PATH from your local Terminal. Add the output of this to the VALET_ASSISTANT_ENV_PATH key in your .env file. This PATH value will then be used whenever the underlying gbuckingham89/valet-assistant package executes a shell command. It is NOT used by code outside that package.
  2. Add /Users/[local-username]/.composer/vendor/bin to the PATH environment for the user running the PHP script (remember to insert the username that Valet is installed under)

Please do your own research and consider any security implications of giving PHP access to additional directories through the PATH environment variable.

🏗 Updating

Before updating, please take a backup of your current installation to prevent any potential data loss.

Before starting, please review the CHANGELOG for any release specific instructions. If you're updating between multiple releases, please review the notes for each release.

To update your installation, perform a GIT pull from the release branch:

git pull origin release

You should then also update the dependencies:

composer install --no-dev

To avoid any potential issues, you should also clear your caches:

php artisan config:clear && php artisan view:clear

🏷 Release process

This project follows Semver 2.0.0 and each new release will be tagged appropriately.

The master branch is the development version. The latest release can be found on the release branch.

There is currently no defined release schedule. Watch this project in GitHub to receive notifications of future releases.

Changelog

Please see CHANGELOG for more information on what has changed in each release, and any particular update instructions that need to be followed.

👨‍💻 Contributing

Contributions are not only welcomed, but encouraged. Please see CONTRIBUTING for details - but if you're unsure of anything, just ask!

🔐 Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

👪 Credits

⚖️ License

The MIT License (MIT). Please see License File for more information.

You might also like...
A skeleton WordPress project to be used as a base for new WordPress projects.
A skeleton WordPress project to be used as a base for new WordPress projects.

BoxUK WordPress Project Skeleton A base WordPress project from Box UK to get you up and running quickly. Installation Create a new project with compos

This repository is pre-configured, clean and empty skeleton for creating a new projects using Kraken Framework.

Kraken Application Skeleton Note: This repository contains pre-configured application skeleton for fast creation of new projects with Kraken Framework

Easily start new projects using FukigenMedia's starterpack.
Easily start new projects using FukigenMedia's starterpack.

Fukigen Filament Starterpack Easily start new projects using FukigenMedia's starterpack. Usually, many of us are confused about where to start a new p

Web Sekolah yang dibuat diatas CMS Popoji dengan base Laravel 6. Web Sekolah ini sudah diintegrasikan dengan template semesta-front.

Web Sekolah yang dibuat diatas CMS Popoji dengan base Laravel 6. Web Sekolah ini sudah diintegrasikan dengan template semesta-front.

Gestor de Contraseñas basado en Laravel 8 + PHP 8 + MySQL 8. Self-hosted Password Manager based on Laravel 8 + PHP 8 + MySQL 8.
Gestor de Contraseñas basado en Laravel 8 + PHP 8 + MySQL 8. Self-hosted Password Manager based on Laravel 8 + PHP 8 + MySQL 8.

English Gestor de Contraseñas Esta aplicación permite una gestión completa de contraseñas para múltiples tipos de servicios (web, ssh, teléfonos, wifi

A @laravel based RAD platform for back-office applications, admin/user panels, and dashboards.
A @laravel based RAD platform for back-office applications, admin/user panels, and dashboards.

For the full documentation, visit orchid.software. Introduction Orchid is a free Laravel package that abstracts standard business logic and allows cod

Cipi is a Laravel based cloud server control panel that supports Digital Ocean, AWS, Vultr, Google Cloud, Linode, Azure and other VPS.
Cipi is a Laravel based cloud server control panel that supports Digital Ocean, AWS, Vultr, Google Cloud, Linode, Azure and other VPS.

Cipi is a Laravel based cloud server control panel that supports Digital Ocean, AWS, Vultr, Google Cloud, Linode, Azure and other VPS. It comes with nginx, Mysql, multi PHP-FPM versions, multi users, Supervisor, Composer, npm, free Let's Encrypt certificates, Git deployment, backups, ffmpeg, fail2ban, Redis, API and with a simple graphical interface useful to manage Laravel, Codeigniter, Symfony, WordPress or other PHP applications. With Cipi you don’t need to be a Sys Admin to deploy and manage websites and PHP applications powered by cloud VPS.

EasyPanel is a beautiful, customizable and flexible admin panel based on Livewire for Laravel.
EasyPanel is a beautiful, customizable and flexible admin panel based on Livewire for Laravel.

EasyPanel EasyPanel is a beautiful, customizable and flexible admin panel based on Livewire for Laravel. Features : Easy to install Multi Language RTL

A new blog system based on laravel+vue

Lumen PHP Framework Laravel Lumen is a stunningly fast PHP micro-framework for building web applications with expressive, elegant syntax. We believe d

Releases(0.2.0)
Owner
George Buckingham
Hello! I’m a full stack PHP developer focused on building bespoke applications with Laravel & Vue.js.
George Buckingham
A fork of Laravel Valet to work in Linux.

Introduction Valet Linux is a Laravel development environment for Linux minimalists. No Vagrant, no /etc/hosts file. You can even share your sites pub

Carlos Priego 1.2k Dec 31, 2022
Quick new application creation with Laravel and Valet

Super-powered laravel new for Laravel and Valet Lambo is a command-line tool that replaces the Laravel installer and wraps up the most common tasks yo

Tighten 593 Dec 30, 2022
A Web Artisan list of categorized OPEN SOURCE PROJECTS built with Laravel PHP Framework.

Laravel-Open-Source-Projects A Web Artisan list of categorized OPEN SOURCE PROJECTS built with Laravel PHP Framework. This repository includes a compr

Goodness Toluwanimi Kayode 833 Dec 26, 2022
Initial template to start your awesome Laravel, Tailwind and Vue projects

Features Laravel 8.* Tailwind 2.1 Ready and Loaded @tailwindcss/typography @tailwindcss/forms Dark mode ready All variants enabled by default Vue 2, V

Marc Garcia Torrent 19 Jul 19, 2022
Project skeleton generator for Laravel & Lumen projects

Skeletor Skeletor is a PHP based CLI tool that has been built to take away the pain of setting up a base project skeleton for Laravel & Lumen projects

Wouter 39 Oct 4, 2022
🚀 A quickstart generator for Laravel projects

?? Initializer for Laravel Initializer for Laravel takes a visual, approach to setting up a new Laravel project. Fill out the form, choose the compone

Niclas van Eyk 59 Oct 12, 2022
An Starter Kit For Laravel Projects.

Laravel Starter Kit An Starter Kit For Laravel Projects. Installation 1-Install the package via composer: composer require xmen/starter-kit --with-al

4xmen 16 Jun 15, 2023
OfficeLife manages everything employees do in a company. From projects to holidays to 1 on 1s to ... 🚀

All-in-one software to manage the employee lifecycle Website • Docs • Demo What is OfficeLife If a company wants to have a complete 360 view of what’s

OfficeLife 628 Dec 30, 2022
Scaffolding to add some Mojo to your Drupal projects.

mojo-drupal-scaffold Scaffolding to add some Mojo to your Drupal projects. This package adds scaffolding files for your Drupal project by integrating

Bluehorn Digital 5 Mar 15, 2022