Project Overview

Start here first, learn about the project structure and what's included.

NuGet QuickStart Guide

A simple walkthrough on getting your development environment ready for developing with FaceSharp using NuGet
* Using Attributes on Controllers for authentication.
* JavaScript SDK Initialization Learn how to initialize the Javascript SDK AND Facesharp Server Side at the same time.
* Making Facebook Calls

Developer Guide

FaceSharp comes with a number of built in Facebook API calls, however the GraphAPI is very flexible and you may want to create specific calls, here is how you can do it.

Starter Kit Setup Guide

A simple walkthrough on getting your development environment ready for developing with FaceSharp Starter Kit

Authentication Guide

FaceSharp supports all Facebook authentication methods. This guide helps you understand each and how to use FaceSharp in each situation.

Client Side Development Guide

FaceSharp is not just about server side code, Facebook extends its extensive API to the client side too and also has a number of plugins that are quite useful. Learn about everything front end here.


Learn about the functionality contained with FaceSharp

Useful Links

Want to learn more about all the information available to you check here

Facebook Development 101

Just starting out with Facebook Devleopment, this will help you get up to speed.

Facebook Design Patterns

Learn about LikeGates and other design patterns on Facebook

Facebook Bugs - Help Vote

Sometimes we encounter bugs that impact development that are out of our control, we keep a list of them here.
You can help out by voting on the issues we list to ensure they get better visibility with the Facebook development team.

Archived Documentation


A few files you might find helpful
  • Cannot resolve file macro, invalid file name or id.
  • Cannot resolve file macro, invalid file name or id.

Live Running Bundled Sample App - ShareThrift

The samples are a LIVE running version of FaceSharp built using our CI server (Team City) and are included with the FaceSharp source code.

Why use FaceSharp?

  • It is current AND WELL DOCUMENTED, and comes with a handful of examples..
    • Multiple check-ins each week
    • Supports OAuth 2.0 features in Facebook
    • Supports both older authentication and newer Graph API
    • Is both discoverable and flexible
      • Discoverable Built in support for commonly used objects i.e. var friends = facebookApi.User.GetFriends();
      • Flexible Support for dynamics as well i.e. dynamic friends = facebookApi.GraphApi.MakeGraphRequest("me", "friends", new[] {"id", "name", "first_name", "last_name"});
    • Supports both Facebook Applications (running in facebook (i.e.<<your app name>>) and public sites using Facebook Authentication
    • Built with Hammock for REST toolkit and JSON.NET
      • easy to read, tweak and make it your own.
  • It is well documented
    • Go from nothing to running app in minutes
  • It has a very open license
    • MIT License is very liberal, take the code and do what you want with it.
  • Don't criticize, contribute! (please ;-) )

Recent Blog Posts:

 FaceSharp News Feed 
Wednesday, March 23, 2011  |  From FaceSharp

We’ve just released FaceSharp 2.1, this release includes a sample desktop app with Facebook OAuth authorization for desktop apps. The sample app simply allows you to browse your Facebook photos. FaceSharp 2.1 also includes Advanced Examples showcases how to use FaceSharp to make parallel calls into FaceBook

Friday, March 11, 2011  |  From FaceSharp

Keeping up with Facebook and how companies are using it can be a challenge. Here’s how I try to keep abreast of everything. If you have some other techniques please let me know. Yahoo Pipes Yahoo pipes lets you massage online data with little programming and is extremely fast. I use it to merge rss [...]

Thursday, March 10, 2011  |  From FaceSharp

Learn about the Facebook Like Button in our quick presentation : Facebook like button View more presentations from Patrick Gidich.

Friday, February 25, 2011  |  From FaceSharp

FQL is not just a back end technology.. one important thing to note is that the entire Facebook API is accessible from Javascript as well as through back end code. To start FQL is like SQL but you can execute it against Facebook data. While you can retrieve Facebook data and process it locally, FQL [...]

Thursday, February 24, 2011  |  From FaceSharp

With the rollout of the new Facebook Page Design many new features are available to us, this post primarily concerns the new IFrame Tabs for Pages and new data that gets passed into our page from Facebook when a visitor visits the app. FaceSharp has been updated to take advantage of some of these features. [...]

Tuesday, October 05, 2010  |  From FaceSharp

I’ve come across another bug with the Like button that was causing IE6 to hang.  When using the XFBLM implementation of the Like button, IE creates a duplicate copy of the page with “fb_xd_fragment” in the query string.  This causes the duplicate page to appear in search results, and can lead to inaccurate analytics. I [...]

Monday, October 04, 2010  |  From FaceSharp

On September 15, the same day IE9 Beta was released, Facebook officially dropped IE6 support of Facebook Chat, but how long before ALL IE6 support is dropped?  There are JavaScript errors galore in IE6, even for basic pieces of functionality like “Liking” a Facebook page.  This is a step in the right direction, but when [...]

Monday, October 04, 2010  |  From FaceSharp

There is a widespread Facebook “Like” button bug that causes the inline thumbnail image associated with liked pages on wall posts and user streams to appear as a question mark instead of the image defined in the <meta property=”og:image” content=”" /> tag. Users can verify that the og tag data is accurate by entering the [...]

Thursday, September 16, 2010  |  From FaceSharp

The Facebook Like Button is a very powerful tool. One of the features that is extremely useful is that the Like button essentially turns any regular web page into a virtual fan page in that you can post updates to that page and all the fans will see it in their stream. A challenge in [...]

Tuesday, September 14, 2010  |  From FaceSharp

With the latest release of FaceSharp, all of the core Facebook functionality has bee moved to a separate assembly. The following are direct links into the sample Facebook App running FaceSharp. FQL Example Insights Example Account Example Places Example Dashboard Example Feed Publish Example Notifications Example Likes Example Events Example

Tuesday, September 07, 2010  |  From FaceSharp

There is a Facebook bug that causes “Liked” pages to show the Site Name inconsistently within Wall Posts (sometimes shows Site name, sometimes shows URL).  I’ve found a workaround that appears to work consistently, but until Facebook resolves the issue, it may require some additional work for developers to make sure user Wall Posts appear [...]

Monday, August 23, 2010  |  From FaceSharp

Includes a number of new features: Ability to save users who authenticate with the Facebook App Uses Facebook Post Authorize and Post Remove Callbacks Integrated Places functionality (Currently Facebook only supports read functionality) Add ability to select a page you admin and post to it’s wall (as the page itself) Uses new Facebook Admin Functionality [...]

Sunday, August 22, 2010  |  From FaceSharp

The Facebook Developer Application has been completely updated. The new streamlined interface does a much better job of grouping items together and removing features that are no longer in use. The Post Remove Callback now uses the OAuth 2.0 for Canvas (beta) feature, this means that your application can now know when someone has uninstalled [...]

Monday, August 16, 2010  |  From FaceSharp

What’s new in this release: Support for older style Facebook Authentication Used for Dashboard.IncrementCount REST API Call when attempting to increment the count for a different user than the one who’s session is currently active. Cookie Signature Validation – Prevents tampering with cookies set by Facebook. Retrieving Like information (useful when you want the user [...]

Friday, August 06, 2010  |  From FaceSharp

What’s new: Added support for Facebook’s new OAuth 2.0 functionality. The new signed_request parameter is really nice to work with. General cleanup of code. Added documentation on CodePlex on how to get FaceSharp up and running. Head on over to FaceSharp on Codeplex for the source.

Thursday, August 05, 2010  |  From FaceSharp

Hosted Facebook Applications provide a tiered permission structure containing the following groups: Application Developers Administrators Moderators Why is it that non-hosted Facebook Pages do not offer a similar tiered structure?  The only option available for Pages that need to be reviewed by multiple users before being published is to make all of those users Admins.  [...]

Thursday, July 29, 2010  |  From FaceSharp

An instance of FaceSharp is now up and running at This site is automatically built through the TeamCity continuous integration server (free edition). The MSBuild script (included in the project) automatically creates the website. More details to follow.

Tuesday, July 27, 2010  |  From FaceSharp

The first code drop of FaceSharp is now on codplex at

 FaceSharp News Feed 

Last edited Dec 5, 2011 at 2:23 PM by simnova, version 2


No comments yet.