Briefs Documentation

Copy onto a Web Server (or Dropbox public folder)

In order to load the .brieflist into Briefs, you must first copy that onto a web-accessible location. You can use any server you wish, but if you have a Dropbox account it’s simple. Just copy the .brieflist into your Public folder, then right click that file and select “Copy Public Link” from the Dropbox menu.

Once you have the public link copied to your clipboard, simply paste that link in an email, replacing the http:// protocol with a custom protocol that Briefs recognizes: brief://. So, if your link is the following:

http://dl.dropbox.com/u/144323/idea.brieflist

Then simply replace the protocol so it reads:

brief://dl.dropbox.com/u/144323/idea.brieflist

Copy the substituted link into an email, then open the link on your iPhone. The app will load the brief directly on the phone. Once you exit the brief, you’ll be given the option to save a copy of the brief on your phone.

You can use other apps, such as PasteBot (LINK HERE!!!) to paste the link onto your phone. This is also a handy way to keep the link for sharing with others.

Optionally, Create a Briefcast

Using the code below as a reference, change the relevant information and include references to your briefs inside the items section. It is important that you include a fully qualified path to your brief!

<?xml version="1.0"?>
<rss version="2.0">
    <channel>
        <title>Briefcast Demo</title>
        <link>http://giveabrief.com/briefcast/</link>
        <description> Demonstrate how awesome it is to use a briefcast to get briefs on the iPhone.</description>
        <language>en-us</language>
        <pubDate>Thu, 12 Nov 2009 03:05:00 GMT</pubDate>
        <lastBuildDate>Thu, 12 Nov 2009 03:05:00 GMT</lastBuildDate>
        <item>
            <title>Kitchen Shopping Sketch</title>
            <enclosure url="http://giveabrief.com/cast/shopping.brieflist" length="29230" type="application/brief" />
            <description>An example brief showing how you can use scanned-in pencil sketches.</description>
            <pubDate>Sun, 13 Sep 2009 03:05:00 GMT</pubDate>
            <guid>http://giveabrief.com/cast/1#item1</guid>
        </item>
    </channel>
</rss>

Copy this .xml file to your server (or Dropbox public folder) in a publicly accessible location, along with any referenced briefs. Then you can use the optional briefcast:// protocol to send a reference to your phone and others. An example of such a url:

briefcast://giveabrief.com/cast/briefcast.xml