Don't forget to submit you themes to the repository. Just send an email to hello@twittapp.com with the theme attached.
Files
Please note: none of these files are required, but your theme will suffer the consequences.header.html
Use this file to set anything up that should span the entire page of content. Use footer.html to close what what remains open.Accepted insertables: none.
notice.html
Used when Twitter returns an error that Twitt needs to notify the user about.Accepted insertables: (noticeContent).
tweet.html
A normal tweet.Accepted insertables: (realName), (updateContent), (favorited), (updateFavoritedStatus), (postedTime), (screenName), (avatarURL), (updatePermalink), (twitterUserPage), (replyToUser), (replyToTweet), (reiterate), (retweetIndicator), (undoReiterated), (replyToDirectMessage).
reply.html
A tweet beginning with an @, but not containing the user's username.Accepted insertables: (realName), (updateContent), (favorited), (updateFavoritedStatus), (postedTime), (screenName), (avatarURL), (updatePermalink), (twitterUserPage), (replyToUser), (replyToTweet), (reiterate), (retweetIndicator), (undoReiterated), (replyToDirectMessage), (conversationIndicator).
mention.html
A tweet containing the user's username.Accepted insertables: (realName), (updateContent), (favorited), (updateFavoritedStatus), (postedTime), (screenName), (avatarURL), (updatePermalink), (twitterUserPage), (replyToUser), (replyToTweet), (reiterate), (retweetIndicator), (undoReiterated), (replyToDirectMessage), (conversationIndicator).
directmessage.html
A direct message.Accepted insertables: (realName), (updateContent), (favorited), (updateFavoritedStatus), (postedTime), (screenName), (avatarURL), (updatePermalink), (twitterUserPage), (replyToUser), (replyToTweet), (reiterate), (retweetIndicator), (undoReiterated), (replyToDirectMessage).
retweet.html
An official retweet.Accepted insertables: (realName), (updateContent), (favorited), (updateFavoritedStatus), (postedTime), (screenName), (avatarURL), (updatePermalink), (twitterUserPage), (replyToUser), (replyToTweet), (reiterate), (retweetedBy), (retweetedByAvatar), (retweetIndicator), (undoReiterated), (replyToDirectMessage), (conversationIndicator).
self.html
A tweet from the user.Accepted insertables: (realName), (updateContent), (favorited), (updateFavoritedStatus), (postedTime), (screenName), (avatarURL), (updatePermalink), (twitterUserPage), (replyToUser), (replyToTweet), (reiterate), (retweetIndicator), (undoReiterated), (replyToDirectMessage), (conversationIndicator).
favorite.html
Inserted when (favorited) is found and the tweet should be favorited.Accepted insertables: (favorited), (updateFavoritedStatus).
unfavorite.html
Inserted when (favorited) is found and the tweet should be unfavorited.Accepted insertables: (favorited), (updateFavoritedStatus).
reiteratetoggle.html
Inserted when (reiterateToggle) is found. Show when the user can retweet an update.Hidden if update has been retweeted by the user.
Accepted insertables: (reiterate).
retweetindicator.html
Inserted when (retweetIndicator) is found. Use to indicate when an update has already been retweeted by the user.Hidden unless the update has been retweeted by the user.
Tip: Use (undoReiterated) as a 'href' to allow the user to undo a retweet.
Accepted insertables: (undoReiterated).
conversationIndicator.html
Inserted when (conversationIndicator) is found.Hidden if there is no in-reply-to date.
Accepted insertables: (conversationWithUser), (viewConversation).
footer.html
Use this file to close anything setup in header.html as well as anything that should appear at the bottom of the content.Accepted insertables: none.
archive.html
Used when the user has "Differentiate archived content" checked.Accepted insertables: (archive).
(realName), (updateContent), (favorited), (updateFavoritedStatus), (postedTime), (screenName), (avatarURL), (updatePermalink), (twitterUserPage), (replyToUser), (replyToTweet), (reiterate), (retweetedBy), (retweetIndicator), (undoReiterated), (replyToDirectMessage).
Insertables
(realName)
Real name of user.(updateContent)
Contents of an update.(postedTime)
Localized time for when the update was posted.(screenName)
Screen name of user.(avatarURL)
Inserts: URL.Direct URL to the user picture.
(updatePermalink)
Inserts: URL.Permanent link to the update.
(twitterUserPage)
Inserts: URL.Link to twitter.com/User.
(replyToUser)
Inserts: Action URL.Autofills a new reply to the user.
(replyToTweet)
Inserts: Action URL.Autofills a reply to a specific tweet from a specific user (so it will show up as "in reply to".
(replyToDirectMessage)
Inserts: Action URL.Autofills "d username".
(favorited)
Inserts: Insert point for code.Inserts the code located in favorite.html or unfavorite.html, depending on wether the update is already favorited.
(updateFavoritedStatus)
Inserts: Action URL.Inverts the favorite status of selected update (i.e. if the updated is already favorited, it unfavorites it).
(reiterate)
Inserts: Action URL.Reiterate this tweet. Based off the user's preference, will use official method first or will fill update box with the message (formatted based on the preference).
(retweetedBy)
Inserts the username (with @) of the user who retweeted given update.(retweetedByAvatar)
Inserts: URL.Direct URL to the avatar of the user who retweeted this update.
(reiterateToggle)
Inserts: Action URL.Inserts code found in reiteratetoggle.html. See reiteratetoggle.html.
(retweetIndicator)
Inserts: Insert point for code.Inserts code found in retweetindicator.html. See retweetIndicator.html.
(undoReiterated)
Inserts: Action URL.Inserts an 'href' that destroys the given retweet.
(conversationIndicator)
Inserts: Insert point for code.Used to indicate when a tweet is in reply to another tweet. Inserts the code located in conversationIndicator.html.
(conversationUser)
Inserts: Insert point for code.The username of the author of the tweet that reply is to.
(viewConversation)
Inserts: Action URL.Inserts a link to the tweet that is replied to.
(archive)
Inserts: Archived Update.Indicates where archived content should be inserted.