The Xamarin.Forms framework is designed to simplify the process of building cross-platform apps for iOS, Android, and the Universal Windows Platform (UWP). This open-source repository showcases how developers can leverage different aspects of Xamarin.Forms to create robust and feature-rich mobile applications.

For those looking to dive deeper into the code, individual samples are available for download on Microsoft's official code sample browser. Additionally, you can explore platform-specific forks, such as Tizen (https://github.com/Samsung/xamarin-forms-samples) or GTK# (https://github.com/jsuarezruiz/xamarin-forms-samples/tree/gtk), to unlock even more capabilities.

One of the key benefits of this repository is its welcoming nature - we encourage contributions and suggestions from the developer community! If you have an idea for a new sample, start by raising a GitHub issue in this repository that outlines your proposed sample. Please note that any samples added to the master branch should not rely on preview or pre-release NuGet packages.

The Xamarin.Forms samples featured on Microsoft's samples browser are sourced directly from this repository. To ensure seamless integration with the code sample browser, all samples must comply with specific requirements:

Screenshots and Readme Files

Each sample must include a folder called Screenshots that contains at least one screenshot of the application on each platform (preferably a screenshot for every page or major piece of functionality). The README.md file should provide an overview of the sample, including metadata to help customers find it.

The README file should begin with a YAML header (delimited by---) containing the following keys and values:

  • name: must start with "Xamarin.Forms -"
  • description: a brief summary (< 150 chars) that appears in the sample code browser search
  • page_type: must be set to "sample"
  • languages: should include the coding language(s) used, such as C#, F#, VB, or Java
  • products: should list Xamarin for every sample in this repository
  • urlFragment: please provide a value representing the sample's path in this repo (except directory separators are replaced with dashes)

Here is an example of a working README file from WebServices/TodoREST:

--- name: Xamarin.Forms - TodoREST description: This sample demonstrates a Todo list application where the data is stored and accessed from a RESTful web service. page_type: sample languages: - csharp products: - xamarin urlFragment: webservices-todorest --- # Heading 1 rest of README goes here, including screenshot images and requirements/instructions to get it running

Buildable Solution and .csproj File

Finally, each sample must include a buildable solution and .csproj file. This ensures that the project can be easily built and configured (solution + .csproj files) for integration with the Microsoft sample code browser.

If you have any questions or need help getting started, don't hesitate to create an issue or ask on the Xamarin Forums. By contributing your expertise and creativity, you can help shape the future of swift app development with Xamarin.Forms!