App Kickstarter

Get it

Clone the repository as follows.

git clone --recursive git://github.com/SpaceApi/app-framework.git /srv/http/spaceapi_app

We assumed that your document root is at /srv/http/spaceapi_app. Adapt it to your needs.

Add a new VirtualHost

If you use the apache web server, put the following VirtualHost to your apache configuration file.

<VirtualHost *:80>
    ServerAdmin root@localhost
    DocumentRoot "/srv/http/spaceapi_app"
    ServerName myapp.spaceapi.net
    <Directory /srv/http/spaceapi_app>
                Options -Indexes FollowSymLinks MultiViews
                AllowOverride All
                Order allow,deny
                allow from all
    </Directory>
</VirtualHost>

In Arch Linux these are the files to be considered:

• /etc/httpd/conf/httpd.conf
• /etc/httpd/conf/extra/httpd-vhosts.conf

Configure your DNS

Add a new entry to your /etc/hosts:

127.0.0.1       myapp.spaceapi.net

Prepare your repository

Create a new repository in your Github account or if Gitorious is your favourite git service provider, then in your Gitorious account.

Here we assume that your username is johndoe and your app is about a map. Now run the following commands.

cd apps/myapp
git remote add myapp [email protected]:johndoe/map.git
git config branch.master.remote myapp
git config branch.master.merge refs/heads/master
git push

Develop your app

Now use the content in apps/myapp as a starting point. Put your business logic, your javascript and stylesheets there. Don't forget to commit and push regularly.

git commit <your-canged-files>
git push

Publish your app

Github users

If your work is done,

1. fork and clone the apps repository
2. add your app as a submodule:

   git submodule add git://github.com/johndoe/map.git map

3. open menu.php and add a new entry for your app:

   $menu = array(
       "intro" => "Home",
       "map" => "The ultimate Space API map",
   );
   

   The key map must be the same as your app directory name. The right part is the button text of the menu entry.
4. Now commit your changes and send us a pull request. Then we'll have a look at your work and we'll finally accept it if there are no security concerns.