Show off your hackclub projects with hackvertisements!
Hackvertisements are small banner embeds you can add to your website. Every time it is loaded, it will display a random hackvertisement submitted by fellow hackclubbers, showcasing off a certified cool project :3
Everything is completely free in every sense of the word and the hackvertisements may not be commercial in any way. This is not a place to advertise your vibecoded business. This is however a place for you to showcase that project you're super passionate about!!
-
Install Ruby on Rails (good luck).
-
Clone this :-)
-
Then do
bundle install. -
Do
rails db:create db:migrateto set up the database. -
Then you probably want to set up the .env file! Run
cp .env.example .env, then open .env and follow the instructions there. -
And then you can run the server with
rails sand hope it works!!
There's a local CDN test server that is used for development to not send requests to the real Hackclub CDN during development. It should be run alongside the main rails server. The local CDN test server can be run with python (flask):
python fake_cdn.py
Note: make sure you have set CDN_BASE_URL in your .env.
The user with ID 1, usually the first user to ever login, is marked as the "root user". You can tell if you are the root user by whether you have the admin panel in your navbar. The admin panel displays all uploaded hackvertisements with options to edit and delete.
If you want to make a specific user into the root user, there is a helper script for that. Run it with rails r set_user_as_root.rb
In case there already exists a root user when that script is run, it will ask if you want to move it to another ID.
There's a python helper script for adding fake users to the db. This is particularly useful if you want to avoid setting up Hackclub authentication, as you can use this with the dev login instead.
Launch it using:
python fake_user_adder.py