Welcome to the D3Up.com Github Repository!
I've finally made the decision to release the source code to D3Up.com so that everyone able can help contribute and possibly modify it for other games!
- Bugs and Features - Please use the Github Issues section of the project for any bugs or features you'd like to request, talk about or get help with.
- General Discussion - For anything else, or if you just are a bigger reddit fan, feel free to anything on /r/d3up.
- IRC Chatroom - If you're IRC savvy, feel free to join the chat on
irc.esper.net
in the channel#d3up
.
Server Components:
- PHP 5.4
- MongoDB 2.0+
- A web server that supports URL rewrites, nginx, apache, etc
D3Up uses the following frameworks/bundles:
- Laravel v3 - PHP MVC/MVR Framework
- MyUnit (Bundle) - PHPUnit Wrapper for Laravel
- Binder (Bundle) - HTML Helpers
- S3 (Bundle) - Allows communication with Amazon S3
- EpicMongo - PHP/MongoDB ORM
- jQuery - Javascript Engine
- underscore - Javascript Framework (the Calculators use)
- HandleBars - Javascript Templating Engine
- Bootstrap - CSS Framework / Utilities
EditorConfig - D3Up uses EditorConfig to ensure everyones tabs and spaces are properly aligned. Please make sure you're using an Editor/IDE that supports EditorConfig and please enable it!
If you're wanting to setup a local instance of D3Up, here's a few things you'll need to do:
- Fork the repository so you have your own copy to work on and submit pull requests from.
- Copy
application/config/application.template
toapplication/config/application.php
and change thekey
in the file to a unique value. - Make sure to run
git submodule update --init
to pull in a copy of the libraries/bundles it uses.
My goal here is to ensure all tests (located in the application/tests
folder) pass after any changes are made. More and more tests will be added to test the PHP code and ensure no changes break the site's functionality.
A javascript testing framework will be added as well in the future, but right now, the javascript is kinda an abomination :)
You can run the tests by executing the following command from the command line (in the D3Up.com folder):
php artisan myunit
This requires that PHPUnit is installed on your system, just google for phpunit installation [insert your OS here]
to find out how.
All changes submitted must be in the form of a Pull Request, which will then be reviewed by the community and once accepted, will be merged into the live codebase and deployed to D3Up.com.
This code is released under the MIT License.