= Setup for Cytoscape app development =

== Overview ==

Here we'll fork the ''Cytoscape samples'' repository on !GitHub and import it in Eclipse. The ''Cytoscape samples'' repository contains many example apps that we'll work through later in the ladder. By ''forking'' the repository, you'll create a copy of the repository for yourself that you can commit to.

== Process ==

=== 1. Fork the repository ===

Go to [[https://github.com/cytoscape/cytoscape-app-samples]] and click on the ''Fork'' button. After you've forked your repository, make sure to copy the !GitHub repository URL to your clipboard. The URL should be something like `https://github.com/YOU/cytoscape-app-samples`.

{{attachment:github-fork-repo.png}}

<<BR>>
<<BR>>
<<BR>>
<<BR>>
<<BR>>

=== 2. Import the GitHub Repository into Eclipse ===

In Eclipse, go to the ''File'' menu and choose ''Import''.

{{attachment:import-menu-item.png}}

<<BR>>
<<BR>>
<<BR>>
<<BR>>
<<BR>>

Click the ''Maven'' folder, then select ''Check out Maven Projects from SCM''. Click ''Next''.

{{attachment:import_menu.png}}

<<BR>>
<<BR>>
<<BR>>
<<BR>>
<<BR>>

Click ''m2e Marketplace''.

{{attachment:2_no_git_import.png}}

<<BR>>
<<BR>>
<<BR>>
<<BR>>
<<BR>>

Search for "egit", click ''m2e-egit'' to check it, and then click Finish and install egit. You will need to restart Eclipse.

{{attachment:3_egit_dl.png}}

<<BR>>
<<BR>>
<<BR>>
<<BR>>
<<BR>>

Once egit is installed and Eclipse re-opens, navigate to ''File > Import'', then click ''Maven'' and ''Check out Maven Projects from SCM''.

{{attachment:import_menu.png}}

<<BR>>
<<BR>>
<<BR>>
<<BR>>
<<BR>>

Click the drop-down menu and set it to ''git'', and paste your forked repository URL into the text box, click Finish.

{{attachment:final_import.png}}

<<BR>>
<<BR>>
<<BR>>
<<BR>>
<<BR>>


Okay! You're all done importing your !GitHub repository. You'll see all the sample apps the left.

{{attachment:5_final.png}}