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.

1. Make sure you have Laravel Homestead installed.

2. Clone this repository.

   git clone [email protected]:LaravelIO/laravel-io.git laravelio/
   cd laravelio/
   

3. Add the path for the cloned laravel.io repository to the Homestead.yml file under the folders list.

4. Add a site lio.loc for the laravel.io repository to the Homestead.yml file under the sites list.

5. Run vagrant provision in your Homestead folder.

6. Create a database in Homestead called laravelio.

7. Run composer install --dev and php artisan migrate --env=local.

8. Add 192.168.10.10 lio.loc to your computer's hosts file.

You can now visit the app in your browser by visiting http://lio.loc/.

Now, we must install the oauth configuration.

1. 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

2. 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, or compass 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.