Stars: 118
Forks: 35
Pull Requests: 14
Issues: 4
Watchers: 6
Last Updated: 2023-02-02 05:38:24
Administration system for Hackathons :chart_with_upwards_trend: !
License: GNU Affero General Public License v3.0
Languages: PHP, HTML, Dockerfile, Shell
In order to ensure active development going forward, we are looking for maintainers to join the project. Please contact the project owner if you are interested. and see CONTRIBUTING.md for information on what you can do about that.
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 !
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 :
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 ) .
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() ;
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
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
Don't forget to put your hackathon name in environment variable APP_NAME
( .env
file )
Put your hackathon logo in the folder /public/images
with the name of LOGO.png
You find the hackathon landing page section in the folder /resources/views/sections
with a clean and simple code
To customize the decision and confirmation emails for your event, edit email templates in
/resources/views/emails
/admin
[email protected]
and cse
you can change them in the migrations folder database/migrations
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 !
If you have any questions about this software, please contact [email protected] or [email protected] .
Copyright (c) 2019 Scientific Club Of ESI (https://github.com/ScientificClubofESI). Released under AGPLv3. See LICENSE
for details.