VisualSVN Documentation

Getting Started

Version control with VisualSVN is user friendly and straightforward. You don't need to have prior Subversion experience.

To get started with VisualSVN you should have the following software installed:

  • Visual Studio 2003, 2005 or 2008 (all editions except Express are supported),
  • TortoiseSVN (version 1.4.8 or higher is recommended),
  • VisualSVN (version 1.4.0 or higher is recommended).

Add Solution to Subversion

First you need to place your solution under Subversion control. There are only two main steps to do this: execute the “Add Solution to Subversion” command and commit your solution to the repository.

Executing the “Add Solution to Subversion” command

Open or create new solution in Visual Studio. Then choose Add Solution to Subversion from the VisualSVN menu command and the wizard will open.

Now you should choose the repository where your code history will be stored. VisualSVN can add your code to a new or an existing repository. When VisualSVN creates new repository it creates the default structure with branches, tags and trunk folders. Initially your code will be stored in the trunk folder.

Add Solution to Subversion

Now you choose the directory where your code will be stored. VisualSVN can add your code to a new or an existing repository. When VisualSVN creates new repository it creates the default repository structure with branches, tags and trunk folders. Initially your code will be stored in the trunk folder.

Please note that when adding your code to an existing repository you can choose any remote repository. For example, you can easily add your solution to a hosted repository provided by third-party hosting services. Just enter the repository URL in the corresponding field in the dialog.

After this operation is finished all source files and folders in your solution will be marked as added to Subversion. Added files will be indicated by yellow icons in Solution Explorer. But all changes are still local and have not been sent to the target repository yet. This allows you to review the results of adding your solution to Subversion before the operation is finished.

Yellow status after "Add Solution to Subversion"

Commit Solution to Subversion

To commit your solution to Subversion, select VisualSVN | Commit menu item, enter a comment and click OK. The first versions of your source files will be sent to the target Subversion repository.

Commit of imported solution

After you committed your solution to Subversion you should see green icons in Solutions Explorer indicating that your code is controlled by Subversion and you have no local changes. You are ready to work!

Green status after Commit