This is the Laravel.IO community portal site. The site is entirely open source and community involvement is not only encouraged, but required in order to ensure the future success of the project.
We use Laravel Homestead for local development. Please review the Homestead documentation to install it.
In order to compile stylesheets you will also need Ruby, Sass, and Compass installed.
Here are the steps for installation on a local machine.
-
Make sure you have Laravel Homestead installed.
-
Clone this repository.
git clone [email protected]:LaravelIO/laravel-io.git laravelio/ cd laravelio/
-
Add the path for the cloned laravel.io repository to the
Homestead.yml
file under thefolders
list. -
Add a site
lio.loc
for the laravel.io repository to theHomestead.yml
file under thesites
list. -
Run
vagrant provision
in your Homestead folder. -
Create a database in Homestead called
laravelio
. -
Run
composer install --dev
andphp artisan migrate --env=local
. -
Add
192.168.10.10 lio.loc
to your computer'shosts
file.
You can now visit the app in your browser by visiting http://lio.loc/.
Now, we must install the oauth configuration.
-
Create an application in your github account called something like "Laravel IO Development" and add your GH application's client id and secret to this config file. Your GitHub Application should be set up as follows:
a. Full URL: http://lio.loc b. Callback URL: http://lio.loc/login
-
Create the configuration file below at app/config/packages/artdarek/oauth-4-laravel/config.php
<?php
return [
'storage' => 'Session',
'consumers' => [
'GitHub' => [
'client_id' => 'YOUR_NEW_CLIENT_ID_HERE',
'client_secret' => 'YOUR_NEW_CLIENT_SECRET_HERE',
'scope' => ['user'],
],
],
];
Because we keep the generated / minified css out of the repository, we must have a workflow for compiling the styles.
- Be sure you have Ruby, Sass, and Compass installed on your machine
- When running any compass command in the terminal, be sure to run it from your
/public
folder. - Compass is the tool used to compile Sass source files into CSS files; you can run
compass compile
to run it once, orcompass watch
to trigger a script that will watch your Sass files for changes and trigger a new compass compile on each change
The Laravel.IO project is currently maintained by Dries Vints. If you have any questions please don't hesitate to ask them in an issue or email me at [email protected].
All tests can be run with the following command. Make sure to run this inside the Homestead box.
$ vendor/bin/phpunit
Please see CONTRIBUTING for details.
The MIT License (MIT). Please see License File for more information.