Create an Application

This page describes how to create your own repository based on this template, and use git/GitHub so you can track the latest changes.

These instructions assume you have a GitHub account. I recommend installing GitHub Desktop, which can help you configure git correctly and easily review and push changes.

Steps to create your own repository

Create a new repository in GitHub using the web interface. Do not initialize the repository with any README.md, .gitignore, LICENSE, etc. Just leave it empty. For our purposes, suppose the new repository is named https://github.com/susom/my-app.

Clone the template project using the "bare" option and push it back into our new repository.

git clone --bare https://github.com/susom/vertx-template.git
cd vertx-template.git
git push --mirror https://github.com/susom/my-app
cd ..
rm -rf vertx-template.git

Now clone the new repository so you can work on it.

git clone https://github.com/susom/my-app

If you don't already have IntelliJ installed, now would be a good time. Either the free or paid edition should be sufficient.

Either drag the my-app directory to IntelliJ or go to File / Open... and select the my-app directory.

Choose the Main run configuration (or navigate to class Main.java) and run it. You should see a link in the console, which will open the app in your browser.

Sync your repository

If you want to pull the latest changes from the vertx-template repository, you can set up your local git clone so it knows about the template.

git remote add template https://github.com/susom/vertx-template
git pull template master
git push origin master