diff --git a/docs/doxygen/mainpages/platdetails.h b/docs/doxygen/mainpages/platdetails.h
index 789e4fd38d..6daca76a2d 100644
--- a/docs/doxygen/mainpages/platdetails.h
+++ b/docs/doxygen/mainpages/platdetails.h
@@ -169,6 +169,14 @@ wxQt is a port of wxWidgets using Qt libraries. It requires Qt 5 or later.
 
 For further information, please see the files in docs/qt in the distribution.
 
+@section page_port_wxiOS wxiOS
+
+wxiOS is a port of wxWidgets using Cocoa touch libraries for iOS. It is very
+basic in it current form, but is included for further improvements and very
+simple applications.
+
+For further information, please see the files in docs/ios in the distribution.
+
 @section page_port_nativedocs Native Toolkit Documentation
 
 It's sometimes useful to interface directly with the underlying toolkit
diff --git a/docs/index.htm b/docs/index.htm
index 698859bf67..1ba22ee05d 100644
--- a/docs/index.htm
+++ b/docs/index.htm
@@ -48,7 +48,8 @@
       <a href="motif/readme.txt">wxMotif</a>,
       <a href="qt/readme.txt">wxQt</a>
       <a href="x11/readme.txt">wxX11</a>,
-      <a href="univ/readme.txt">Univ</a>
+      <a href="univ/readme.txt">Univ</a>,
+      <a href="ios/readme.txt">wxiOS</a>
     </li>
     <li>Installation:
       <a href="msw/install.txt">wxMSW</a>,
diff --git a/docs/ios/readme.txt b/docs/ios/readme.txt
new file mode 100644
index 0000000000..96f229c312
--- /dev/null
+++ b/docs/ios/readme.txt
@@ -0,0 +1,45 @@
+   Welcome to wxWidgets for iOS
+   ----------------------------
+
+wxiOS is far from a full supported port, but can be used
+as base for simple applications and future improvements.
+
+It requires Xcode with iOS SDK 9.0 or later. Xcode is available
+for free in the OS X app store.
+
+More info about the wxWidgets project (including all the
+other ports and version of wxWidgets) can be found at the
+main wxWidgets homepage at:
+
+    https://www.wxwidgets.org/
+
+To build wxiOS you should use Xcode to open the minimal samples
+Xcode project file located at:
+
+    samples/minimal/minimal_iphone.xcodeproj
+
+That project files includes wxiphone.xcodeproj so you just need
+to hit run in order to see the minimal sample running in the
+simulator.
+
+The library can also be build via configure/make:
+
+    mkdir build_ios
+    cd build_ios
+    ../configure --with-osx_iphone --enable-monolithic \
+        --with-macosx-version-min=8.0 --disable-shared \
+        --with-macosx-sdk=$(xcrun --sdk iphonesimulator --show-sdk-path)
+    make
+
+
+Please send problems concerning installation, feature requests,
+bug reports or comments to the wxWidgets users list. These can
+be found at https://www.wxwidgets.org/support/mailing-lists/
+
+wxWidgets doesn't come with any guarantee whatsoever. It
+might crash your harddisk or destroy your monitor. It doesn't
+claim to be suitable for any special or general purpose.
+
+  Regards,
+
+    The wxWidgets Team