From 8b529f47dde14a5dc3cd2bb9cf32bc4d2c8a8968 Mon Sep 17 00:00:00 2001
From: Diego Giagio <diego@giagio.com>
Date: Tue, 9 Oct 2018 17:40:45 -0400
Subject: [PATCH] Create README.md

---
 README.md | 162 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 162 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e644d9e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,162 @@
+# Warp
+Warp lets you create self-contained single binary applications making it simpler and more ergonomic to deliver your application to your customers. A self-contained binary is specially convenient when the technology you use, such as .NET Core, Java and others, contain many dependencies that must be shipped alongside your application.
+
+Warp is supported on Linux, Windows and macOS.
+
+## Quickstart with .NET Core
+### Linux
+**Create a simple console application**
+
+```sh
+dgiagio@X1:~/Devel$ mkdir myapp
+dgiagio@X1:~/Devel$ cd myapp
+dgiagio@X1:~/Devel/myapp$ dotnet new console
+dgiagio@X1:~/Devel/myapp$ dotnet run
+Hello World!
+dgiagio@X1:~/Devel/myapp$
+```
+
+**Publish the application with native installer for `linux-x64` runtime**
+
+```sh
+dgiagio@X1:~/Devel/myapp$ dotnet publish -c Release -r linux-x64
+```
+The application should be published to `bin/Release/netcoreapp2.1/linux-x64/publish/`
+
+**Download `warp-packer`**
+
+If you save `warp-packer` in a directory in your PATH, you only need to download it once.
+```sh
+dgiagio@X1:~/Devel/myapp$ curl -Lo warp-packer https://github.com/dgiagio/warp/releases/download/v0.1.0/linux-x64.warp-packer
+dgiagio@X1:~/Devel/myapp$ chmod +x warp-packer
+```
+
+**Create your self-contained application**
+
+```sh
+dgiagio@X1:~/Devel/myapp$ ./warp-packer --arch linux-x64 --input_dir bin/Release/netcoreapp2.1/linux-x64/publish --exec myapp --output myapp
+dgiagio@X1:~/Devel/myapp$ chmod +x myapp
+```
+
+**Run your self-contained application**
+
+```sh
+dgiagio@X1:~/Devel/myapp$ ./myapp
+Hello World!
+dgiagio@X1:~/Devel/myapp$
+```
+
+**More information about your self-contained application**
+
+```sh
+dgiagio@X1:~/Devel/myapp$ file myapp
+myapp: ELF 64-bit LSB executable, x86-64, version 1 (GNU/Linux), statically linked, BuildID[sha1]=13b12e71a63ca1de8537ad7e90c83241f9f87f6c, with debug_info, not stripped
+
+dgiagio@X1:~/Devel/myapp$ du -hs myapp
+34M     myapp
+```
+
+### macOS
+**Create a simple console application**
+
+```sh
+Diegos-iMac:Devel dgiagio$ mkdir myapp
+Diegos-iMac:Devel dgiagio$ cd myapp
+Diegos-iMac:myapp dgiagio$ dotnet new console
+Diegos-iMac:myapp dgiagio$ dotnet run
+Hello World!
+Diegos-iMac:myapp dgiagio$
+```
+
+**Publish the application with native installer for `osx-x64` runtime**
+
+```sh
+Diegos-iMac:myapp dgiagio$ dotnet publish -c Release -r osx-x64
+```
+The application should be published to `bin/Release/netcoreapp2.1/osx-x64/publish/`
+
+**Download `warp-packer`**
+
+If you save `warp-packer` in a directory in your PATH, you only need to download it once.
+```sh
+Diegos-iMac:myapp dgiagio$ curl -Lo warp-packer https://github.com/dgiagio/warp/releases/download/v0.1.0/macos-x64.warp-packer
+Diegos-iMac:myapp dgiagio$ chmod +x warp-packer
+```
+
+**Create your self-contained application**
+
+```sh
+Diegos-iMac:myapp dgiagio$ ./warp-packer --arch macos-x64 --input_dir bin/Release/netcoreapp2.1/osx-x64/publish --exec myapp --output myapp
+Diegos-iMac:myapp dgiagio$ chmod +x myapp
+```
+
+**Run your self-contained application**
+
+```sh
+Diegos-iMac:myapp dgiagio$ ./myapp
+Hello World!
+Diegos-iMac:myapp dgiagio$
+```
+
+**More information about your self-contained application**
+
+```sh
+Diegos-iMac:myapp dgiagio$ file myapp
+myapp: Mach-O 64-bit executable x86_64
+
+Diegos-iMac:myapp dgiagio$ du -hs myapp
+ 27M    myapp
+```
+
+### Windows
+**Create a simple console application**
+
+```powershell
+PS C:\Users\Diego\Devel> mkdir myapp
+PS C:\Users\Diego\Devel> cd myapp
+PS C:\Users\Diego\Devel\myapp> dotnet new console
+PS C:\Users\Diego\Devel\myapp> dotnet run
+Hello World!
+PS C:\Users\Diego\Devel\myapp>
+```
+
+**Publish the application with native installer for `win10-x64` runtime**
+
+```powershell
+PS C:\Users\Diego\Devel\myapp> dotnet publish -c Release -r win10-x64
+```
+The application should be published to `bin/Release/netcoreapp2.1/win10-x64/publish/`
+
+**Download `warp-packer`**
+
+If you save `warp-packer` in a directory in your PATH, you only need to download it once.
+```powershell
+PS C:\Users\Diego\Devel\myapp> [Net.ServicePointManager]::SecurityProtocol = "tls12, tls11, tls" ; Invoke-WebRequest https://github.com/dgiagio/warp/releases/download/v0.1.0/windows-x64.warp-packer.exe -OutFile warp-packer.exe
+```
+
+**Create your self-contained application**
+
+```powershell
+PS C:\Users\Diego\Devel\myapp> .\warp-packer --arch windows-x64 --input_dir bin/Release/netcoreapp2.1/win10-x64/publish --exec myapp.exe --output myapp.exe
+```
+
+**Run your self-contained application**
+
+```powershell
+PS C:\Users\Diego\Devel\myapp> .\myapp.exe
+Hello World!
+PS C:\Users\Diego\Devel\myapp>
+```
+
+**More information about your self-contained application**
+
+```powershell
+PS C:\Users\Diego\Devel\myapp> "{0:N2} MB" -f ((Get-ChildItem .\bin\Release\netcoreapp2.1\win10-x64\publish -Recurse | Measure-Object -Property Length -Sum -ErrorAction Stop).Sum / 1MB)
+65.99 MB
+```
+
+## Quickstart with Java
+_In progress_
+
+## How it works
+_In progress_