Creating a new code repo from a local working copy
with the Github for Mac app
- From the repositories view in the app, drag the project folder to the bottom of the left sidebar.
- Hit 'Yes' when it asks if you want to create a local git repository
- Go to 'Changes' view (⌘2)
- Select the files that you want to commit their current state to the repository. You can view the changes of the file by clicking on the double up arrow on the file name bar.
- Type a commit summary, usually a description of what you've just added or changed.
- Click 'Commit'. This commits the current state of the code to your local repository. Do this every time to do something significant like fix a bug or develop a feature. Commit early and often. Each state of code is available to you at any time via the History view (⌘1).
Macos-terminal-themes Color themes for default macOS Terminal.app. This is a set of color themes for default macOS Terminal.app (initially ported from iTerm2 color schemes, collected by @mbadolato). Screenshots are demonstrated below and in the screenshots/ directory of this repo. Git is a collection of concepts implemented and combined in a way that's hard to abstract. If you don't expose the details of exactly what's happening, either you lose much of its power or you run the risk of destroying things.
Visual Studio for Mac will now push the changes to your remote GitHub repository: Clone an existing repository. It's likely that you'll have to work with a GitHub repo that exists only on the remote, not on your local machine. Visual Studio for Mac allows you to clone this repo quickly. Follow the steps below to clone it to your machine.
with the command line
- Open Terminal.app
- 'cd' to directory
- Initiate a git repository
- Add existing files
- Commit all files (-a) and add a message (-m)
Cloning (checking out) someone else's repository
with the Github for Mac app
- Visit the repo on Github.com and click the 'clone to Mac' button, or...
- Select the repo in the Repositories list within the app, under the cremalab account.
with the command line
- 'cd' to desired directory
- clone the repo with the clone url
Syncing repository branches with a remote repository
with the Github for Mac app
- Make sure you have committed the current state of your code
- Drill into your repo in the app and click Sync Branch in the upper right corner. This pulls down the latest code from the remote repository, merges your code with it, and pushes your changes to the remote repository.
If you only want to get the latest code from the remote repo, select Repository > Pull (⇧⌘P) from the menu bar. This merges the remote code with your local code but does not push up your changes.
Apple Terminal App
If you only want to push up your current state to the remote reop, select Repository > Push (⌘P). This will only work if you already have the most up to date code from the repo.
with the command line
- Make sure you have committed your current state.
- Get the most up to date code from the remote repo
- Push your local code to the remote repo
After writing versions of this guide in three different places, here's a more abstract version that should work for the 99% of Laravel apps out there.
Requirements
Before getting started, here are some thing you'll need:
- PHP 7. Learn how to install it in Windows, Mac or Linux
- Composer. Learn how to install it
- A terminal. Your OS should already come with one
Get the code into your computer
Let's assume the project is hosted on GitHub (or GitLab, any git service should work). The preferred method would be to perform a git clone. You can do this by running the following in your terminal of choice:
Of course, not everyone has or wants to use git, so almost all git services offer a way to download zipped version of the repository. Just search for a Download ZIP option. Then, you'll want to unzip it before proceeding to the next step.
Installing dependencies
To light up the size of the repository, Laravel projects rarely bundle their dependencies with them. You'll need to use composer to download them. To do this, just open a terminal window on the repository folder and run the following:
Mac Os X Terminal App
This process may take between half a minute and five minutes depending on the number of dependencies.
Setting up the database
Most Laravel apps require a database. To keep it simple, we're gonna use a sqlite database, which is just a simple file and requires no external programs. To configure it, search for a .env.example file on the repository and rename it to .env . You'll also need to open the database folder and create an empty file called database.sqlite . After this, open your .env file in a text editor and make the following changes:
Finally, open up a terminal window and run the following command:
Setting up the application key
Easy one! Just open up a terminal window, run the following and you're done!
Get a server running
You can use almost any server to serve your app but, to keep it simple, we're gonna use Laravel's integrated one. Open up a terminal window and run the following command:
You should now be able to access your app by using this link.
That's it!
If everything went right, you should now be watching the main page of your Laravel project. Congratulations, and enjoy the power of Laravel!