+
+# XPlat Windows APIs
+
+XPlat Windows APIs are designed to make it easier for developers adjusted to developing with the Windows Runtime APIs (UWP) to take those skills cross-platform with their applications in .NET.
+
+As each application platform offers their own unique platform-specific APIs, XPlat attempts to bring all of those APIs under one umbrella using a UWP like API, allowing a developer to learn a single API which works with any application built for Windows and Xamarin for Android and iOS.
+
+For a Windows developer, this is appealing as it allows you to easily migrate your existing Windows code to Xamarin shared code with minimal changes through the use of XPlat Windows APIs which mimic the UWP API alternatives.
+
+## Why should I use this project?
+
+You've spent years developing Windows applications and you've been using the Windows Runtime APIs (UWP) to build modern app experiences. Now you want to take your existing apps and skills cross-platform with Xamarin, but you don't know where to start because you don't know what APIs to use!
+
+I had this same problem!
+
+That's where XPlat Windows APIs started, a set of APIs which mimic those Windows APIs but that are cross-platform, supporting both Android and iOS.
+
+Use your existing skills and build epic cross-platform applications.
\ No newline at end of file
diff --git a/docs/articles/toc.yml b/docs/articles/toc.yml
new file mode 100644
index 0000000..c6fa19c
--- /dev/null
+++ b/docs/articles/toc.yml
@@ -0,0 +1,6 @@
+- name: Overview
+ topicHref: intro.md
+- name: Get started
+ items:
+ - name: Available packages
+ href: available-packages.md
diff --git a/docs/docfx.json b/docs/docfx.json
new file mode 100644
index 0000000..cc7ac2c
--- /dev/null
+++ b/docs/docfx.json
@@ -0,0 +1,82 @@
+{
+ "metadata": [
+ {
+ "src": [
+ {
+ "src": "../",
+ "files": [
+ "src/**.csproj"
+ ],
+ "exclude": [
+ "**/bin/**",
+ "**/obj/**",
+ "_site/**"
+ ]
+ }
+ ],
+ "dest": "api",
+ "disableGitFeatures": false,
+ "disableDefaultFilter": false,
+ "properties": {
+ "TargetFramework": "netstandard2.0"
+ }
+ }
+ ],
+ "build": {
+ "content": [
+ {
+ "files": [
+ "api/**.yml",
+ "api/index.md"
+ ]
+ },
+ {
+ "files": [
+ "articles/**.md",
+ "articles/**/toc.yml",
+ "toc.yml",
+ "*.md"
+ ]
+ }
+ ],
+ "resource": [
+ {
+ "files": [
+ "images/**"
+ ]
+ }
+ ],
+ "overwrite": [
+ {
+ "files": [
+ "apidoc/**.md"
+ ],
+ "exclude": [
+ "obj/**",
+ "_site/**"
+ ]
+ }
+ ],
+ "dest": "_site",
+ "globalMetadataFiles": [],
+ "fileMetadataFiles": [],
+ "template": [
+ "default",
+ "templates/material"
+ ],
+ "postProcessors": [],
+ "markdownEngineName": "markdig",
+ "noLangKeyword": false,
+ "keepFileLink": false,
+ "cleanupCacheHistory": false,
+ "disableGitFeatures": false,
+ "globalMetadata": {
+ "_appLogoPath": "images/Logo.png",
+ "_appFaviconPath": "images/Logo.png",
+ "_appTitle": "XPlat Windows APIs",
+ "_appFooter": "Copyright (c) XPlat Apps",
+ "_enableSearch": true,
+ "_enableNewTab": true
+ }
+ }
+}
\ No newline at end of file
diff --git a/docs/images/Logo.png b/docs/images/Logo.png
new file mode 100644
index 0000000..ad84416
Binary files /dev/null and b/docs/images/Logo.png differ
diff --git a/docs/images/ProjectBanner.png b/docs/images/ProjectBanner.png
new file mode 100644
index 0000000..d8fef60
Binary files /dev/null and b/docs/images/ProjectBanner.png differ
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 0000000..f9dd6b8
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,76 @@
+---
+uid: front-page
+title: Docs
+---
+
+
+
++Find yourself with .NET Windows API skills but unsure how to go cross-platform? +
++That's why I started XPlat Windows APIs. This is an API layer for Xamarin Android and iOS application mimicking the equivalent Windows API. So you can build cross-platform applications with the skills you know! +
+ ++Take advantage of what is available for XPlat Windows APIs in your applications. +
++You'll discover what packages are available for you from NuGet.org, plus how you can use them. +
+ ++Are we missing an API you need in your application? +
++XPlat Windows APIs are available as an open-source project on GitHub! Dive into the codebase and bring your improvements. +
+ ++If you'd like to support our current and future endeavors in open-source projects, considering sponsoring the work we do! +
+ + +