README.md

This project has been ported to go! Visit the new repo here -> https://github.com/devict/job-board

devICT Job Board

The greatest job board in all the universe. You've never seen job postings like this before. This baby is jam-packed with features: It's got jobs, it's got links; it's got it all! Before you visit the homepage for the first time, I recommend you find somewhere to sit down because you're not gonna know what hit you. When you first lay eyes on this thing, you might feel compelled to add a new life event to your Facebook timeline - that's normal - this job board is undoubtedly life changing. The ripples of its impact will be felt across space and time. Arias will be written, wars will be fought, masterworks will be produced all in the name of the devICT Job Board.

Installation

Step one is to clone this repo:

git clone https://github.com/devict/jobs.devict jobs.devict
cd jobs.devict

If you're looking to get started quickly we recommend using our Docker setup. If you already have PHP (>= 7.2.0), PHP Composer, SQLite3, and NPM on your machine you can follow our basic setup steps.

Docker Setup

Copy config files, install dependencies.

cp .env.example .env
cp .db.env.example .db.env

Edit both files to set a database password (they must match).

Next run..

make setup

Now, start things by running docker compose.

make start

Then in another terminal session, create and migrate the database. The server must be running in order for the migrate command to work.

make db-migrate

Visit http://localhost:8001!

Basic Setup

Install PHP dependencies:

composer install

Install NPM dependencies:

npm install

Build assets:

npm run watch

Create a SQLite database: (You can also use another database [MySQL, Postgres], simply update your configuration accordingly)

touch database/database.sqlite

Copy the environment config example and rename it to .env:

cp .env.example .env

Generate an application key:

php artisan key:generate

Run database migrations:

php artisan migrate

Start the built-in web server:

php artisan serve

You're ready to go! Visit http://127.0.0.1:8000 in your browser.

Notifications

The Job Board will send an email and Slack notification when new jobs are added to the board. The recipient of these notifications is configured in the .env file. Set the JOBS_EMAIL value to a valid email address and the JOBS_SLACK_HOOK to a valid Slack webhook. Both of these settings are optional and the Job Board should still function without them set.

Icons

This project uses the Zondicons icon set.

Running tests

Run the PHPUnit tests:

vendor/bin/phpunit

Logging into the database

$ make psql

This command will launch a psql sessions into the running database on the docker-compose service.

Sponsors

This project is supported by: