Chapter 18. Forking on GitHub
Prev Part V. Contributing to Recess Next

Chapter 18. Forking on GitHub

Table of Contents

Working with Recess as a Git Submodule

Forking Recess Edge on GitHub is easy, and the complete instructions can be found over at GitHub: http://github.com/guides/fork-a-project-and-submit-your-modifications

Working with Recess as a Git Submodule

When developing with the edge version of Recess it can be a pain to maintain source control for your application. Luckily Git has a notion of submodules which allow other git repositories to be embedded within parent repositories. Follow these steps to setup Recess Edge as a submodule within your application's git repository:

  1. cd into your project's directory

  2. git submodule add git://github.com/recess/recess.git ./edge/

  3. cp edge/.htaccess .

  4. cp edge/recess-conf.php .

  5. cp edge/bootstrap.php .

  6. cp -R edge/apps apps/

  7. cp -R edge/data/ data/

  8. cp -R edge/plugins/ plugins/

  9. (this is excessive - getting public assets from edge's tools dir into your app dir)

  10. mkdir recess

  11. mkdir recess/recess

  12. mkdir recess/recess/apps

  13. mkdir recess/recess/apps/tools

  14. cp -R edge/recess/recess/apps/tools/public recess/recess/apps/tools/public

  15. Modify recess-conf.php

    // Paths to the recess, plugins, and apps directories
    RecessConf::$recessDir = $_ENV['dir.bootstrap'] . 'edge/recess/';

Prev Up Next
Part V. Contributing to Recess Home Chapter 19. Setting up PHPUnit for Recess