Create GitHub Repo on a New Laravel Project
Adam Bailey • October 31, 2021laravel configuration
This year, Laravel added a new feature to easily create a new git repository when creating a new project. This article explains how to use the GitHub CLI to go even further.
Installing GitHub CLI
In order to utilize the GitHub tooling for the laravel installer, you'll need to have
git already installed, as well
as GitHub CLI installed globally.
GitHub CLI brings GitHub to your terminal. Free and open source.
I simply installed the CLI using Homebrew, with
brew install gh in the terminal. After installation, restart your
terminal, and continue with the Laravel installation.
First, you'll need a basic understanding of how to install Laravel, and you'll need Composer installed beforehand. For the purposes of this article, we'll be building on macOS and using GitHub. You may use the official Laravel documentation to get you started.
To initialize git, you can now just supply a flag on the Laravel installer command. We will be focusing on the GitHub portion of this Laravel installation.
To create a new repository on GitHub when installing the new Laravel project, simply supply the
--github flag as follows:
1laravel new example-app --github
This will put your new project in a private repository at
To change the initial branch name to use
1laravel new example-app --github --branch="main"
To make your repo public, add the
1laravel new example-app --github="--public"
That's about all there is to it! This saves a lot of time (and potential Googling) trying to set up a new repo and initialize git with a new Laravel project.