LaraHack is a complete administration systems designed especially for hackathons and similar competitions .

For participants , it's a clean and simple to submit application with or without team and confirm attendance .

For Organizers , it's an easy way to create your hackathon website , view registrations , analyze statistics , Check-In and much more !

Features

WebSite Template : LaraHack has a website template that contains all necessary sections ( About,Challenges,Sponsors.. ) with a clean code so you can modify and customize it .
Registration : With LaraHack hackers can register easily with or without a team through a register view that is similar to TypeForm and also.
Statistics : The admin has access to a lot of statistics about registration such us registrations rate per day , decisions about hackers ... and muc more !
Dashboard : Admin can view all applications to the hackathon , take a decision and export data to Excel or CSV .
Mailing : LaraHack is able to send emails such as :
- Successful application: which is sent to every hacker who apply , informing him that his application is done successfully and providing him with his team's name and team's code if he choosed to register with a team .
- Decision : Waiting list , Rejected Or Accepted with confirm attendance link .
Check-In : Allows organizers to check the participants present at the event day .
Settings : Configure some essential settings ( at the moment it contains only the possibility to close or open registrations ) .

Screenshots

Setup

Quick deploy with Heroku

Requirements

Requirement	Version
PHP	`7.1+`
Composer	`1.8+`
MySQL	`8.0+`

Run the following commands to check the current installed versions:

php --version

For MySQL You can run this command in MySQL Commande Line Client :

select version() ;

Deploy locally

Getting a local instance of LaraHack up and running is very quickly ! Start By Creating A Database on MySQL and go with these steps :

1 - Clone the repository and cd to the project folder:

git clone https://github.com/ScientificClubofESI/LaraHack 
cd LaraHack

2 - Install the necessary dependencies:

composer install

3 - Create your .env file from .env.example and generate an app key ( Don't forget to configure it with the database, and your email , if the host is googlemail so let mail driver , host and port as it was in env.example ) :

cp .env .env.example
php artisan key:generate

4 - Migrate the database and start listening a queue in different terminal :

php artisan migrate 
php artisan queue:listen database

5 - Finally run the server :

php artisan serve

Deploy Using Docker

Getting a local instance of LaraHack up and running is very quickly using docker-compose

1 - Clone the repository and cd to the app folder:

$ git clone https://github.com/ScientificClubofESI/LaraHack 
cd LaraHack

2 - Change the ownership of the app:

$ sudo chown -R www-data:www-data 'LocalAppPath'
'LocalAppPath' ex: ~/LaraHack

3 - copy the config file:

$ cp .env.example.docker .env

4 - Mount the app directory and install the dependencies:

$ docker run --rm -v $(pwd):/app composer install --no-dev

5 - Build the app image and run the services:

$ docker-compose up -d

Customizing for your event

Hackathon name

Don't forget to put your hackathon name in environment variable APP_NAME ( .env file )

Hackathon Logo

Put your hackathon logo in the folder /public/images with the name of LOGO.png

Hackathon Landing Page

You find the hackathon landing page section in the folder /resources/views/sections with a clean and simple code

Mail Content

To customize the decision and confirmation emails for your event, edit email templates in /resources/views/emails

Notes :

Access to the admin dashboard via the link /admin
The default mail and password are : [email protected] and cse you can change them in the migrations folder database/migrations

Contributing

Do you have a feature request, bug report, or patch? Great! See CONTRIBUTING.md for information on what you can do about that. Contributions to LaraHack are welcome and appreciated !

Feedback / Questions

If you have any questions about this software, please contact [email protected] or [email protected] .

projectbarks / larahack Goto Github PK

larahack's Introduction