Quick links

• Quick start
• Overview

Documentation

• Guides
  • tapestry-model guide
  • tapestry-conversations guide
  • tapestry-exceptionpage guide
  • tapestry-hibernate-seedentity guide
  • tapestry-jpa guide
  • tapestry-resteasy guide
  • tapestry-security guide
  • tapestry-watchdog guide
• Javadocs
  • tapestry-model
  • tapestry-conversations
  • tapestry-exceptionpage
  • tapestry-hibernate-seedentity
  • tapestry-jpa
  • tapestry-resteasy
  • tapestry-security
  • tapestry-watchdog
• Dependencies
  • tapestry-model-core
  • tapestry-conversations
  • tapestry-exceptionpage
  • tapestry-hibernate-seedentity
  • tapestry-jpa
  • tapestry-security
  • tapestry-resteasy
  • tapestry-watchdog

Examples

• tapestry-conversations (on GAE)

Project information

• Release history
• Roadmap
• Continuous Integration
• Issue Tracking
• Mailing Lists
• Project License
• Project team
• Source repository

Tool links

• Fisheye view on SVN
• Confluence Wiki
• JIRA
• Bamboo CI

Feeds

• Site
• News

Creating the project

First, you'll need to download and install maven2 if you haven't already done so. You *don't* have to use Maven, but it makes things substantially easier by managing all of the dependencies in Tynamo. Even if it initially takes you a while to learn Maven, it saves you a lot of time as your project gets bigger.

If you are not familiar with Maven, here are some links that'll help you get to learn the basics Maven: The Definitive Guide Maven Users Centre

Next, issue the following command (on a single line):

mvn archetype:generate -DarchetypeCatalog=http://tynamo.org

Use Maven 2.1.x or newer (otherwise you need to specify the archetype plugin version with mvn org.apache.maven.plugins:maven-archetype-plugin:2.0-alpha-4:generate since the older archetype plugin version don't know how to handle :generate goal)

If you really want to use snapshot archetypes, use:

mvn archetype:generate -DarchetypeCatalog=http://ci.repository.codehaus.org/org/tynamo/tynamo-archetype/

This will download the Tynamo archetype and any plugins needed. It will then create a working Tynamo project.

Running the project

Starting up your application is super simple, just go into your new project directory and do:

mvn jetty:run

This will download all dependencies, build your project and start it in the jetty container. Be warned, this can take some time, especially if you just started using maven. If any downloads fail, try running this again. Sometimes the maven repositories get bogged down. When everything finishes, you will now be able to go to http://localhost:8080/

Import your project

Setting up an Eclipse project is also very simple. First, you will need to tell Eclipse how to find your maven repository. This is a one time step for each Eclipse workspace:

mvn -Declipse.workspace=<path-to-eclipse-workspace> eclipse:add-maven-repo

Now do:

mvn eclipse:eclipse

You should now be able import your project into Eclipse and ready to add your own domain classes!