Contribs folder

In order to run a development version of pouet.net on your platform, you need to have a HTTP webserver, PHP and MySQL.

How to contribute ?

First thing, you need to fork it. Then you can start making changes on your fork. When done, you can create a pull request and a people will review your change and test it on a staging version of the website. When your PR is ready to go live, a contributor will merge it into master and your proposed changes will automatically go live on Pouët in the next 5 minutes.

When is a new version deployed ?

Anytime a commit is pushed into the master branch, Pouët gets a call from Github and starts deploying a new version.

Setup a dev environment

OS X

Clone the pouet.net repo, let's say it's now in /Users/you/src/pouet.net
Install MAMP, it's free
Launch it
In the preferences, on the Apache pane, put /Users/you/src/pouet.net as the document root
Start the servers

Now you need to create the pouet user and the pouet database in your newly installed MySQL server.

Run /Applications/MAMP/Library/bin/mysql -uroot -proot and execute the following SQL commands:

CREATE DATABASE `pouet`;
CREATE USER 'pouet'@'localhost' IDENTIFIED BY 'pouet';
GRANT ALL PRIVILEGES ON pouet.* TO 'pouet'@'localhost';

Once done, you test your MySQL user by doing:

/Applications/MAMP/Library/bin/mysql -upouet -ppouet pouet

I suggest you install Sequel Pro for all the MySQL stuff, it's free too !

Next, you want some starting data to play with, let's inject the structure of the live database:

/Applications/MAMP/Library/bin/mysql -upouet -ppouet pouet < /Users/you/src/pouet.net/pouet.sql

Now you should be able to open your local pouet on http://localhost:8888/ !

To Be Continued...