Laravel site for Project Nisei
Branch: master
Clone or download
Latest commit 7e3b008 Feb 9, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app Fix rss feed content to show 200 chars, plus header image Jan 9, 2019
bootstrap Initial commit Oct 12, 2018
config Included views as discussed with Mike P Nov 20, 2018
database rename index property to position Dec 11, 2018
public Add Patreon badge. Feb 9, 2019
resources Merge pull request #43 from Absotively/patreon Feb 10, 2019
routes Fix Event Policies & FAQ name; add link to available kits page Dec 18, 2018
storage Initial commit Oct 12, 2018
tests Initial commit Oct 12, 2018
.editorconfig Initial commit Oct 12, 2018
.env.example Restore .env.example Nov 19, 2018
.gitattributes Initial commit Oct 12, 2018
.gitignore Added new resources to OP Resources page. Dec 11, 2018
README.md mention port site will be available at Feb 6, 2019
Vagrantfile 😏😏😏😏 Mar 4, 2018
app.dockerfile add node dependency to app container Feb 6, 2019
artisan Initial commit Oct 12, 2018
composer.json Add article rss feed Nov 11, 2018
composer.lock Add article rss feed Nov 11, 2018
docker-compose.yml initial docker config Feb 6, 2019
package-lock.json finish COC and add css for quote Oct 27, 2018
package.json Init masonry post imageload Nov 10, 2018
phpunit.xml Initial commit Oct 12, 2018
server.php Initial commit Oct 12, 2018
vhost.conf initial docker config Feb 6, 2019
web.dockerfile initial docker config Feb 6, 2019
webpack.config.js Set up node, sass and rebuild nav Oct 13, 2018
webpack.mix.js Initial commit Oct 12, 2018

README.md

Project NISEI Site

The Project NISEI site has been built in Laravel 5.5 and the core project code was generated using QuickAdminPanel.

To set the site up in a dev environment you will need a full LAMP stack set up, if you don't already have this available I'd recommend using Scotch Box, a Vagrant box which should come with everything you need already installed (although any other setup should work fine as long as you can run Laravel). Scotch Box comes with it's own set up instructions to get everything in place (VirtualBox, Vagrant, Scotch itself). Once this stack is fully set up and Vagrant is booted, you should be able to view the scotch box landing page at your local scotch box ip (default: http://192.168.33.10).

This project is built on top of scotch so to get in sync you can: git remote rm origin git remote add origin [[this repo]] git fetch git pull origin master

From there you can ssh into Vagrant with vagrant ssh and navigate to /var/www/ which is the web root of the server and reflects the contents of your project folder on your machine. The site is now installed but must be configured to run.

  • Set up .env (as a copy of .env.example) with your local environment details, including database logins that are included in the Scotch Box docs
  • run composer install (this will install a lot of stuff, especially if you haven't got many php packages in cache)
  • run php artisan key:generate
  • run php artisan vendor:publish and select all
  • run php artisan migrate to populate the databases with tables
  • run php artisan db:seed to populate the default user and roles

At this point the site should be functional (although missing styles on the front end). You can proceed to /admin and login with the default user, admin@admin.com - password to access the back end of the site. To acquire styles and js you can then.

  • run npm install
  • run npm run build:sass
  • run npm run build:js

If you have issues with node-sass at this point, those can potentially be resolved by running npm install --unsafe-perm -g node-sass. Any issues beyond that can be debugged as a group in Slack.

Once everything is up and running, pull requests can be made to the main repo (on a feature branch) and deployed to live once reviewed.

Docker instructions

Ensure that you have docker and docker compose installed

Start containers with

docker-compose up

composer install can be run using the following command

  • docker run --rm -v $(pwd):/app composer install --ignore-platform-reqs --no-scripts (MacOS/Linux)
  • docker run --rm -v %cd%:/app composer install --ignore-platform-reqs --no-scripts (Windows)

The commands below composer install can be run by prefixing the command with docker-compose run app . This will execute the command in the app container.

Site will be available at http://localhost:8081.