/portal

The Laravel.io Community Portal

Primary LanguagePHPMIT LicenseMIT

Laravel.io Community Portal

CircleCI StyleCI Laravel Version Software License

This is the repository for the Laravel.io community portal. The code is entirely open source and licensed under the MIT license. We welcome your contributions but we encourage you to read the the contributing guide before creating an issue or sending in a pull request. Read the installation guide below to get started with setting up the app on your machine.

We hope to see your contribution soon!

Table of Contents

Requirements

The following tools are required in order to start the installation.

Installation

Note that you're free to adjust the ~/Sites/laravelio location to any directory you want on your machine.

  1. Clone this repository: git clone git@github.com:laravelio/laravel-io.git ~/Sites/laravelio
  2. Run composer start
  3. Run vagrant up
  4. SSH into your Vagrant box, go to /home/vagrant/Code/laravelio and run composer setup
  5. Add 192.168.10.10 laravelio.test to your computer's /etc/hosts file
  6. Setup a working e-mail driver like Mailtrap
  7. (optional) Set up Github authentication (see below)

You can now visit the app in your browser by visiting http://laravelio.test. If you seeded the database you can login into a test account with johndoe & password.

Github Authentication (optional)

To get Github authentication to work locally, you'll need to register a new OAuth application on Github. Use http://laravelio.test for the homepage url and http://laravelio.test/auth/github for the callback url. When you've created the app, fill in the ID and secret in your .env file in the env variables below. You should now be able to authentication with Github.

GITHUB_ID=
GITHUB_SECRET=
GITHUB_URL=http://laravelio.test/auth/github

Maintainers

The Laravel.io portal is currently maintained by Dries Vints. If you have any questions please don't hesitate to create an issue on this repo or ask us through the #laravelio channel on Slack.

Contributing

Please read the contributing guide before creating an issue or sending in a pull request.

Code of Conduct

Please read our Code of Conduct before contributing or engaging in discussions.

Security Vulnerabilities

If you discover a security vulnerability within Laravel.io, please send an email immediately to Dries Vints at dries.vints@gmail.com. Do not create an issue for the vulnerability.

License

The MIT License. Please see the license file for more information.