Add Vagrant VM

.gitignore

@@ -2,6 +2,24 @@
 .project
 .settings/
 .DS_Store
-config.inc.php
+libs/config.inc.php
 tests/config.tests.inc.php
-data/*
+data/*
+
+.vagrant/*
+
+default/adminer/index.php
+
+html/index.html
+
+puphpet/files/dot/ssh/id_rsa
+
+puphpet/files/dot/ssh/id_rsa.ppk
+
+puphpet/files/dot/ssh/id_rsa.pub
+
+puphpet/files/dot/ssh/root_id_rsa
+
+puphpet/files/dot/ssh/root_id_rsa.ppk
+
+puphpet/files/dot/ssh/root_id_rsa.pub

README.md

@@ -4,12 +4,12 @@ Isosceles is an object-oriented, PHP5 web application starter kit based on [Thin
 underpinnings. Isosceles provides a simple MVC framework, database agnosticism, caching, dynamic class loading,
 single-file configuration, URL routing and (eventually) common actions like user registration, login, and logging.
 
-Isosceles' name was inspired by the architecture of New York City's 
+Isosceles' name refers to the architecture of New York City's
 [One World Trade Center](http://en.wikipedia.org/wiki/One_World_Trade_Center).
 
 ## Features
 
-Isosceles is the PHP framework that runs [ThinkUp](http://thinkupapp.com/), extracted and abstracted for reuse. It is
+Isosceles is the PHP framework that runs [ThinkUp](https://thinkup.com/), extracted and abstracted for reuse. It is
 nowhere near done. Its current feature set includes:
 
 * [Model View Controller](http://en.wikipedia.org/wiki/Model_view_controller) framework, using
@@ -28,7 +28,7 @@ registration, login, application settings, and logging.
 ## License
 
 Isosceles' source code is licensed under the [GNU General Public License](http://www.gnu.org/licenses/gpl.html), except
-for the  external libraries listed below.
+for the external libraries listed below.
 
 ## External libraries
 
@@ -37,3 +37,72 @@ The following libraries are included in Isosceles:
 * [SimpleTest](http://www.simpletest.org/)
 * [Smarty](http://smarty.net)
 * [Bootstrap](http://twitter.github.com/bootstrap/)
+
+## Develop Locally via Vagrant Virtual Machine
+
+### Requirements
+
+* [Vagrant](https://vagrantup.com)
+* [VirtualBox](https://www.virtualbox.org/)
+* ```vagrant plugin install vagrant-bindfs```
+
+### Install
+
+Clone the repository:
+
+    $ git clone git@github.com:ginatrapani/isosceles.git
+
+Get required submodules:
+
+    $ cd isosceles; git submodule init; git submodule update --recursive
+
+### Run Development Environment
+
+Spin up virtual machine: (first run takes awhile)
+
+    $ vagrant up
+
+All done? Congratulations!
+
+SSH in and run the tests
+
+    [host] $ vagrant ssh
+    [guest] $ cd /var/www/; sudo php tests/all_tests.php
+
+### Use
+
+See Isosceles example web app in your browser:
+
+* http://isosceles.dev/
+
+Note: If isosceles.dev doesn't resolve, make sure the following line is in your host computer's /etc/hosts file:
+
+    192.168.56.101 default isosceles.dev www.isosceles.dev
+
+Use the code editor and git client of your choice on your host machine. Edit files in the isosceles directory.
+
+### Tools
+
+Adminer database admin:
+
+* http://192.168.56.101/adminer/
+* isosceles / nice2bnice
+
+MailCatcher
+
+* http://192.168.56.101:1080/
+
+SSH in:
+
+    $ vagrant ssh
+
+Destroy virtual machine:
+
+    $ vagrant destroy
+
+Note:  This does not delete setup files or the contents of the default directory.
+
+### Modify
+
+This Vagrant virtual machine was built with [PuPHPet](http://puphpet.com). To modify it for your own purposes, drag and drop puphpet/config.yaml onto (http://puphpet.com) and regenerate.
+