always specify '-H windowsgui' for windows

2026-04-22 15:26:15 -07:00 · 2020-09-14 21:42:47 -05:00
1471 changed files with 782 additions and 143048 deletions
@@ -1,12 +0,0 @@
-# These are supported funding model platforms
-
-github: [ leaanthony ]
-patreon: # Replace with a single Patreon username
-open_collective: # Replace with a single Open Collective username
-ko_fi: # Replace with a single Ko-fi username
-tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
-community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
-liberapay: # Replace with a single Liberapay username
-issuehunt: # Replace with a single IssueHunt username
-otechie: # Replace with a single Otechie username
-custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
@@ -0,0 +1,35 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+#####################################################
+     If you have a technical issue, please do not open a bug this way! 
+                      Please use the `wails issue` command!                          
+#####################################################
+
+**Description**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behaviour:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behaviour**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**System Details**
+Please provide your platform, GO version and variables, etc
+
+**Additional context**
+Add any other context about the problem here.
@@ -1,83 +0,0 @@
-name: Bug Report
-description: Create a report to help us improve
-# title: ""
-labels: ["bug"]
-
-body:
-  - type: markdown
-    attributes:
-      value: |
-        ***Please note: No new bug reports are being accepted for Wails v1***
-        Before submitting this issue, please do the following:
-        - Do a web search for your error. This usually leads to a much better understanding of the issue.
-        - Prove that the error is indeed a Wails bug and not an application bug, with a specific set of steps to reproduce. 
-        - Search the issue tracker using [this link](https://github.com/wailsapp/wails/issues?q=is%3Aissue+).
-        - Search the [discussion forums](https://github.com/wailsapp/wails/discussions?discussions_q=type+your+issue+here).
-        - Read the [Troubleshooting Guide](https://wails.io/docs/next/guides/troubleshooting).
-        - Try to fix it yourself. Keep a list of things you have done to fix the problem.   
-
-        If after doing all the above, the problem remains, please continue with this ticket providing *all* the information requested.
-
-        Bug reports that do not follow these steps will likely be closed, so please help us to help you.
-
-  - type: textarea
-    id: description
-    attributes:
-      label: Description
-      description: A clear and concise description of what the bug is.
-      placeholder: A clear and concise description of what the bug is.
-      # value: ""
-    validations:
-      required: true
-  - type: textarea
-    id: reproduce
-    attributes:
-      label: To Reproduce
-      description: Steps to reproduce the behaviour
-      placeholder: |
-        1. Go to '...'
-        2. Click on '....'
-        3. Scroll down to '....'
-        4. See error
-    validations:
-      required: true
-  - type: textarea
-    id: expected-behaviour
-    attributes:
-      label: Expected behaviour
-      description: A clear and concise description of what you expected to happen.
-      placeholder: A clear and concise description of what you expected to happen.
-    validations:
-      required: true
-  - type: textarea
-    id: screenshots
-    attributes:
-      label: Screenshots
-      description: If applicable, add screenshots to help explain your problem.
-      placeholder: If applicable, add screenshots to help explain your problem.
-    validations:
-      required: false
-  - type: textarea
-    id: attempted-fixes
-    attributes:
-      label: Attempted Fixes
-      description: A list of things you have tried to fix the problem, including search engine links.
-      placeholder: A list of things you have tried to fix the problem, including search engine links.
-    validations:
-      required: false
-  - type: textarea
-    id: systemetails
-    attributes:
-      label: System Details
-      description: Please add the output of `wails doctor`.
-      render: shell
-    validations:
-      required: true
-  - type: textarea
-    id: additional-context
-    attributes:
-      label: Additional context
-      description: Add any other context about the problem here.
-      placeholder: Add any other context about the problem here.
-    validations:
-      required: false
@@ -1,5 +0,0 @@
-blank_issues_enabled: false
-contact_links:
-  - name: GitHub Community Discussions
-    url: https://github.com/wailsapp/wails/discussions
-    about: If your question is not a feature or a bug, please go to the discussion panel and retrieve if your question already exists before submitting.
@@ -1,39 +0,0 @@
-name: Documentation
-description: Report an issue related to documentation.
-# title: ""
-labels: ["documentation"]
-
-body:
-  - type: markdown
-    attributes:
-      value: |
-        This template is only used for documentation related requests, including:
-
-        - Log undocumented APIs
-        - Update link
-        - Documentation other than non-project code
-
-        If you followed the documentation but things don't work, take some time to consider if it's the documentation or the code that's wrong. In the latter, prefer using the "[Bug Report](https://github.com/wailsapp/wails/issues/new?assignees=&labels=bug&template=bug_report.yml)" template.
-
-  - type: checkboxes
-    attributes:
-      label: Have you read the Documentation Contribution Guidelines?
-      options:
-        - label: I have read the [Documentation Contribution Guidelines](https://wails.io/docs/next/contributing/documenting).
-          required: true
-
-  - type: textarea
-    attributes:
-      label: Description
-      description: A clear and concise description of what the issue is.
-    validations:
-      required: true
-
-  - type: checkboxes
-    attributes:
-      label: Self-service
-      description: |
-        If you feel like you could contribute to this issue, please check the box below. This would tell us and other people looking for contributions that someone's working on it.
-        If you do check this box, please send a pull request within 7 days so we can still delegate this to someone else.
-      options:
-        - label: I'd be willing to address this documentation request myself.
@@ -1,39 +0,0 @@
-name: Feature request
-description: Suggest an idea for this project
-# title: ""
-labels: ["enhancement"]
-
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Before opening a feature request, please check the [Roadmap](https://github.com/wailsapp/wails/discussions/1484) to see if it has already been requested.
-        ***Please note: No new feature requests are being accepted for Wails v1***
-
-  - type: textarea
-    attributes:
-      label: Is your feature request related to a problem? Please describe.
-      description: A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-    validations:
-      required: false
-
-  - type: textarea
-    attributes:
-      label: Describe the solution you'd like
-      description: A clear and concise description of what you want to happen.
-    validations:
-      required: true
-
-  - type: textarea
-    attributes:
-      label: Describe alternatives you've considered
-      description: A clear and concise description of any alternative solutions or features you've considered.
-    validations:
-      required: false
-
-  - type: textarea
-    attributes:
-      label: Additional context
-      description: Add any other context or screenshots about the feature request here.
-    validations:
-      required: false
@@ -8,7 +8,6 @@ exemptLabels:
  - security
  - onhold
  - inprogress
-  - "Selected For Development"
 # Label to use when marking an issue as stale
 staleLabel: wontfix
 # Comment to post when marking an issue as stale. Set to `false` to disable
@@ -17,6 +16,4 @@ markComment: >
  recent activity. It will be closed if no further activity occurs. Thank you
  for your contributions.
 # Comment to post when closing a stale issue. Set to `false` to disable
-closeComment: false
-exemptMilestones: true
-exemptAssignees: true
+closeComment: false
@@ -1,50 +0,0 @@
-name: Sync upstream branch and deploy mirror | 同步上游分支并部署镜像
-
-on:
-  schedule:
-    - cron: "0 8,20 * * *"
-  workflow_dispatch:
-
-jobs:
-  build-and-deploy:
-    name: Automatic deployment | 自动部署
-    runs-on: ubuntu-latest
-    if: github.repository == 'misitebao/wails'
-
-    steps:
-      - name: Checkout | 切换到部署分支
-        uses: actions/checkout@v2
-        with:
-          ref: "master"
-          submodules: true
-          fetch-depth: 0
-
-      - name: Setup Git | 设置Git
-        run: |
-          git config --local user.email "i@misitebao.com"
-          git config --local user.name "misitebao"
-
-      - name: Add remote upstream repository and sync | 添加远程上游仓库并同步
-        run: |
-          git remote add upstream https://github.com/wailsapp/wails
-          git pull -v --progress --no-rebase "upstream" master
-
-      - name: Push | 推送
-        uses: ad-m/github-push-action@master
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          branch: ${{ github.ref }}
-
-      - name: Build Site | 构建网站
-        run: |
-          cd website &&
-          npm install && npm run build
-
-      - name: Deploy to Server | 部署到服务器
-        uses: hengkx/ssh-deploy@v1.0.1
-        with:
-          HOST: ${{ secrets.DEPLOY_HOST }}
-          USERNAME: ${{ secrets.DEPLOY_HOST_USER }}
-          PASSWORD: ${{ secrets.DEPLOY_HOST_PASSWORD }}
-          SOURCE: "website/build"
-          TARGET: "/www/wwwroot/wails.top"
@@ -1,10 +1,8 @@
 name: latest pre-release
 on:
  push:
-    branches:
-      - develop
    tags:
-      - '**-pre**'
+    - '**-pre**'
 jobs:

  build:
@@ -15,10 +13,10 @@ jobs:
        os: [ubuntu-latest, windows-latest, macOS-latest]
    steps:

-    - name: Set up Go 1.16
+    - name: Set up Go 1.13
      uses: actions/setup-go@v1
      with:
-        go-version: 1.16
+        go-version: 1.13
      id: go

    - name: Check out code into the Go module directory
@@ -13,10 +13,10 @@ jobs:
        os: [ubuntu-latest, windows-latest, macOS-latest]
    steps:

-    - name: Set up Go 1.16
+    - name: Set up Go 1.13
      uses: actions/setup-go@v1
      with:
-        go-version: 1.16
+        go-version: 1.13
      id: go

    - name: Check out code into the Go module directory
@@ -29,4 +29,4 @@ jobs:
      run: go build -v ./cmd/wails

    - name: Test
-      run: ./wails version
+      run: ./wails version
@@ -15,10 +15,10 @@ jobs:
        os: [ubuntu-latest, windows-latest, macOS-latest]
    steps:

-    - name: Set up Go 1.16
+    - name: Set up Go 1.13
      uses: actions/setup-go@v1
      with:
-        go-version: 1.16
+        go-version: 1.13
      id: go

    - name: Check out code into the Go module directory
@@ -31,4 +31,4 @@ jobs:
      run: go build -v ./cmd/wails

    - name: Test
-      run: ./wails version
+      run: ./wails version
@@ -1,29 +0,0 @@
-name: Runtime
-on:
-  push:
-    branches:
-      - v2-alpha
-    paths:
-      - 'v2/internal/frontend/runtime/**'
-jobs:
-  rebuild-runtime:
-    name: Rebuild the runtime
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
-        with:
-          node-version: 14.17.6
-          cache: 'npm'
-          cache-dependency-path: v2/internal/frontend/runtime/package-lock.json
-      - run: npm install
-        working-directory: v2/internal/frontend/runtime
-      - run: npm run build
-        working-directory: v2/internal/frontend/runtime
-
-      - name: Commit changes
-        uses: devops-infra/action-commit-push@master
-        with:
-          github_token: "${{ secrets.GITHUB_TOKEN }}"
-          commit_prefix: "[AUTO]"
-          commit_message: "The runtime was rebuilt"
@@ -16,19 +16,4 @@ examples/**/example*
 cmd/wails/wails
 .DS_Store
 tmp
-node_modules/
-package.json.md5
-v2/test/**/frontend/dist
-v2/test/**/build/
-v2/test/frameless/icon.png
-v2/test/hidden/icon.png
-v2/test/kitchensink/frontend/public/bundle.*
-v2/pkg/parser/testproject/frontend/wails
-v2/test/kitchensink/frontend/public
-v2/test/kitchensink/build/darwin/desktop/kitchensink
-v2/test/kitchensink/frontend/package.json.md5
-/v2/internal/ffenestri/windows/test/cmake-build-debug/
-!v2/internal/ffenestri/windows/x64/webview2.dll
-!v2/internal/ffenestri/windows/x64/WebView2Loader.dll
-.idea/
-v2/cmd/wails/internal/commands/initialise/templates/testtemplates/
+node_modules/
@@ -1,8 +1,4 @@
 {
  "go.formatTool": "goimports",
-  "eslint.alwaysShowStatus": true,
-  "files.associations": {
-    "__locale": "c",
-    "ios": "c"
-  }
+  "eslint.alwaysShowStatus": true
 }
@@ -1,2 +1,34 @@

-The current changelog may be found at: https://wails.io/changelog/
+2019-07-20 **v0.17.6-pre**
+* Significant refactor of runtime 
+* Removed wailsbridge file - now a unified approach taken
+* Fixed React on Windows - Thanks [Florian Didran](https://github.com/fdidron)!
+
+2019-06-18 **v0.16.0**
+* React template FTW! - Thanks [admin_3.exe](https://github.com/bh90210)!
+* Updated contributors
+* Arch Linux detection without lsb-release
+* Removed deprecated methods for dealing with JS/CSS in the backend
+
+2019-05-29 **v0.14.11-pre**
+* Windows fix for spinner
+
+2019-05-29 **v0.14.10-pre**
+* Windows fix for Vuetify
+
+2019-05-29 **v0.14.9-pre**
+* Vuetify project template 🎉
+
+2019-05-29 **v0.14.8-pre**
+* Updated Ubuntu npm install command
+
+2019-05-22 **v0.14.7-pre**
+* New projects are built automatically when initialised
+* Go 1.12 is now a minimum requirement
+
+2019-05-21 **v0.14.6-pre**
+* Hotfix for module dependency issue
+
+2019-05-20 **v0.14.5-pre**
+* Added developer tooling - New Template Generator
+* Documentation fixes - Thanks [admin_3.exe](https://github.com/bh90210)!
@@ -1,2 +1,37 @@
+# Contributors

-The latest contributors list may be found at: https://wails.io/credits#contributors
+Wails is what it is because of the time and effort given by these great people. A huge thank you to each and every one!
+
+  * [Dustin Krysak](https://wiki.ubuntu.com/bashfulrobot)
+  * [Qais Patankar](https://github.com/qaisjp)
+  * [Anthony Lee](https://github.com/alee792)
+  * [Adrian Lanzafame](https://github.com/lanzafame)
+  * [Mattn](https://github.com/mattn)
+  * [0xflotus](https://github.com/0xflotus)
+  * [Michael D Henderson](https://github.com/mdhender)
+  * [fred2104](https://github.com/fishfishfish2104)
+  * [intelwalk](https://github.com/intelwalk)
+  * [Mark Stenglein](https://github.com/ocelotsloth)
+  * [admin_3.exe](https://github.com/bh90210)
+  * [iceleo-com](https://github.com/iceleo-com)
+  * [fallendusk](https://github.com/fallendusk)
+  * [Nikolai Zimmermann](https://github.com/Chronophylos)
+  * [Toyam Cox](https://github.com/Vaelatern)
+  * [Robin Eklind](https://github.com/mewmew)
+  * [Kris Raney](https://github.com/kraney)
+  * [Jack Mordaunt](https://github.com/JackMordaunt)
+  * [Michael Hipp](https://github.com/MichaelHipp)
+  * [Travis McLane](https://github.com/tmclane)
+  * [Reuben Thomas-Davis](https://github.com/Rested)
+  * [Jarek](https://github.com/Jarek-SRT)
+  * [Konez2k](https://github.com/konez2k)
+  * [msms](https://github.com/sayuthisobri)
+  * [dedo1911](https://github.com/dedo1911)
+  * [Florian Didron](https://github.com/fdidron)
+  * [Christopher Murphy](https://github.com/Splode)
+  * [Zámbó, Levente](https://github.com/Lyimmi)
+  * [artem](https://github.com/Unix4ever)
+  * [Tim Kipp](https://github.com/timkippdev)
+  * [Dmitry Gomzyakov](https://github.com/kyoto44)
+  * [Arthur Wiebe](https://github.com/artooro)
+  * [Ilgıt Yıldırım](https://github.com/ilgityildirim)
@@ -1,291 +1,156 @@
 <p align="center" style="text-align: center">
-  <img src="logo-universal.png" width="55%"><br/>
+   <img src="logo_cropped.png" width="40%"><br/>
 </p>
 <p align="center">
-  Build desktop applications using Go & Web Technologies.<br/><br/>
-  <a href="https://github.com/wailsapp/wails/blob/master/LICENSE">
-    <img src="https://img.shields.io/badge/License-MIT-blue.svg">
-  </a>
-  <a href="https://goreportcard.com/report/github.com/wailsapp/wails">
-    <img src="https://goreportcard.com/badge/github.com/wailsapp/wails"/>
-  </a>
-  <a href="http://godoc.org/github.com/wailsapp/wails">
-    <img src="https://img.shields.io/badge/godoc-reference-blue.svg"/>
-  </a>
-  <a href="https://www.codefactor.io/repository/github/wailsapp/wails">
-    <img src="https://www.codefactor.io/repository/github/wailsapp/wails/badge" alt="CodeFactor" />
-  </a>
-  <a href="https://github.com/wailsapp/wails/issues">
-    <img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat" alt="CodeFactor" />
-  </a>
-  <a href="https://app.fossa.io/projects/git%2Bgithub.com%2Fwailsapp%2Fwails?ref=badge_shield" alt="FOSSA Status">
-    <img src="https://app.fossa.io/api/projects/git%2Bgithub.com%2Fwailsapp%2Fwails.svg?type=shield"/>
-  </a>
-  <a href="https://houndci.com">
-    <img src="https://img.shields.io/badge/Reviewed_by-Hound-8E64B0.svg"/>
-  </a>
-  <a href="https://github.com/avelino/awesome-go" rel="nofollow">
-    <img src="https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg" alt="Awesome"/>
-  </a>
-  <a href="https://github.com/wailsapp/wails/workflows/release/badge.svg?branch=master" rel="nofollow">
-    <img src="https://github.com/wailsapp/wails/workflows/release/badge.svg?branch=master" alt="Release Pipelines"/>
-  </a>
-<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-<a href='#contributors'><img src='https://img.shields.io/badge/all_contributors-1-orange.svg?style=flat' alt='Contributors'/></a>
-<!-- ALL-CONTRIBUTORS-BADGE:END -->
+   A framework for building desktop applications using Go & Web Technologies.<br/><br/>
+   <a href="https://github.com/wailsapp/wails/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg"></a>
+   <a href="https://goreportcard.com/report/github.com/wailsapp/wails"><img src="https://goreportcard.com/badge/github.com/wailsapp/wails"/></a>
+   <a href="http://godoc.org/github.com/wailsapp/wails"><img src="https://img.shields.io/badge/godoc-reference-blue.svg"/></a>
+   <a href="https://www.codefactor.io/repository/github/wailsapp/wails"><img src="https://www.codefactor.io/repository/github/wailsapp/wails/badge" alt="CodeFactor" /></a>
+   <a href="https://github.com/wailsapp/wails/issues"><img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat" alt="CodeFactor" /></a>
+   <a href="https://app.fossa.io/projects/git%2Bgithub.com%2Fwailsapp%2Fwails?ref=badge_shield" alt="FOSSA Status"><img src="https://app.fossa.io/api/projects/git%2Bgithub.com%2Fwailsapp%2Fwails.svg?type=shield"/></a>
+   <a href="https://houndci.com"><img src="https://img.shields.io/badge/Reviewed_by-Hound-8E64B0.svg"/></a>
+   <a href="https://github.com/avelino/awesome-go" rel="nofollow"><img src="https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg" alt="Awesome"></a>
+   <a href="https://github.com/wailsapp/wails/workflows/release/badge.svg?branch=master" rel="nofollow"><img src="https://github.com/wailsapp/wails/workflows/release/badge.svg?branch=master" alt="Release Pipelines"></a>
 </p>

-<span id="nav-1"></span>
+The traditional method of providing web interfaces to Go programs is via a built-in web server. Wails offers a different approach: it provides the ability to wrap both Go code and a web frontend into a single binary. Tools are provided to make this easy for you by handling project creation, compilation and bundling. All you have to do is get creative!

-## Internationalization
-
-[English](README.md) | [简体中文](README.zh-Hans.md)
-
-<span id="nav-2"></span>
-
-## Table of Contents
-
-<details>
-  <summary>Click me to Open/Close the directory listing</summary>
-
- [1. Internationalization](#nav-1)
- [2. Table of Contents](#nav-2)
- [3. Introduction](#nav-3)
-  - [3.1 Official Website](#nav-3-1)
- [4. Features](#nav-4)
- [5. Sponsors](#nav-5)
- [6. Installation](#nav-6)
- [7. FAQ](#nav-8)
- [8. Contributors](#nav-9)
- [9. Special Mentions](#nav-10)
- [10. Special Thanks](#nav-11)
-
-</details>
-
-<span id="nav-3"></span>
-
-## Introduction
-
-The traditional method of providing web interfaces to Go programs is via a built-in web server. Wails offers a different
-approach: it provides the ability to wrap both Go code and a web frontend into a single binary. Tools are provided to
-make this easy for you by handling project creation, compilation and bundling. All you have to do is get creative!
-
-<span id="nav-3-1"></span>
-<hr/>
-<h3><strong>PLEASE NOTE: As we are approaching the v2 release, we are not accepting any new feature requests or bug reports for v1. If you have a critical issue, please open a ticket and state why it is critical.</strong></h3>
-<hr/>
-
-### Version 2
-
-Wails v2 has been released in Beta for all 3 platforms. Check out the [new website](https://wails.io) if you are
-interested in trying it out.
-
-### Legacy v1 Website
-
-The legacy v1 docs can be found at [https://wails.app](https://wails.app).
-
-<span id="nav-4"></span>
+The official docs can be found at [https://wails.app](https://wails.app).

 ## Features

- Use standard Go for the backend
- Use any frontend technology you are already familiar with to build your UI
- Quickly create rich frontends for your Go programs using pre-built templates
- Easily call Go methods from Javascript
- Auto-generated Typescript definitions for your Go structs and methods
- Native Dialogs & Menus
- Supports modern translucency and "frosted window" effects
- Unified eventing system between Go and Javascript
- Powerful cli tool to quickly generate and build your projects
+- Use standard Go libraries/frameworks for the backend
+- Use any frontend technology to build your UI
+- Quickly create Vue, Vuetify or React frontends for your Go programs
+- Expose Go methods/functions to the frontend via a single bind command
+- Uses native rendering engines - no embedded browser
+- Shared events system
+- Native file dialogs
+- Powerful cli tool
 - Multiplatform
- Uses native rendering engines - *no embedded browser*!

-<span id="nav-5"></span>
-
-## Sponsors
-
-This project is supported by these kind people / companies:
-
-<a href="https://github.com/sponsors/leaanthony" style="width:100px;">
-  <img src="/img/silver%20sponsor.png" width="100"/>
-</a>
-<a href="https://github.com/selvindev" style="width:100px;">
-  <img src="https://github.com/selvindev.png?size=100" width="100"/>
-</a>
-<br/>
-<br/>
-<a href="https://github.com/sponsors/leaanthony" style="width:100px;">
-  <img src="img/bronze%20sponsor.png" width="100"/>
-</a>
-
-<a href="https://github.com/codydbentley" style="width:100px">
-  <img src="https://github.com/codydbentley.png?size=100" width="100"/>
-</a>
-<a href="https://www.easywebadv.it/" style="width:100px">
-  <img src="website/static/img/easyweb.png" width="100"/>
-</a>
-<br/>
-<br/>
-<a href="https://github.com/matryer" style="width:100px">
-  <img src="https://github.com/matryer.png" width="100"/>
-</a>
-<a href="https://github.com/tc-hib" style="width:55px">
- <img src="https://github.com/tc-hib.png?size=55" width="55"/>
-</a>
-<a href="https://github.com/picatz" style="width:50px">
-  <img src="https://github.com/picatz.png?size=50" width="50"/>
-</a>
-<a href="https://github.com/tylertravisty" style="width:50px">
-  <img src="https://github.com/tylertravisty.png?size=50" width="50"/>
-</a>
-<a href="https://github.com/akhudek" style="width:50px">
-  <img src="https://github.com/akhudek.png?size=50" width="50"/>
-</a>
-<a href="https://github.com/trea" style="width:50px">
-  <img src="https://github.com/trea.png?size=50" width="50"/>
-</a>
-<a href="https://github.com/LanguageAgnostic" style="width:55px">
-  <img src="https://github.com/LanguageAgnostic.png?size=55" width="55"/>
-</a>
-<a href="https://github.com/fcjr" style="width:55px">
-  <img src="https://github.com/fcjr.png?size=55" width="55"/>
-</a>
-<a href="https://github.com/nickarellano" style="width:60px">
-  <img src="https://github.com/nickarellano.png?size=60" width="60"/>
-</a>
-<a href="https://github.com/bglw" style="width:65px">
-  <img src="https://github.com/bglw.png?size=65" width="65"/>
-</a>
-<a href="https://github.com/marcus-crane" style="width:65px">
-  <img src="https://github.com/marcus-crane.png?size=65" width="65"/>
-</a>
-<a href="https://github.com/bbergshaven" style="width:45px">
-  <img src="https://github.com/bbergshaven.png?size=45" width="45"/>
-</a>
-<a href="https://github.com/Gilgames000" style="width:45px">
-  <img src="https://github.com/Gilgames000.png?size=45" width="45"/>
-</a>
-<a href="https://github.com/ilgityildirim" style="width:50px">
-  <img src="https://github.com/ilgityildirim.png?size=50" width="50"/>
-</a>
-<a href="https://github.com/questrail" style="width:50px">
-  <img src="https://github.com/questrail.png?size=50" width="50"/>
-</a>
-<a href="https://github.com/DonTomato" style="width:45px">
-  <img src="https://github.com/DonTomato.png?size=45" width="45"/>
-</a>
-<a href="https://github.com/taigrr" style="width:55px">
-  <img src="https://github.com/taigrr.png?size=55" width="55"/>
-</a>
-<a href="https://github.com/charlie-dee" style="width:55px">
-  <img src="https://github.com/charlie-dee.png?size=55" width="55"/>
-</a>
-directory
-<a href="https://github.com/michaelolson1996" style="width:55px">
-  <img src="https://github.com/michaelolson1996.png?size=55" width="55"/>
-</a>
-<a href="https://github.com/GargantuaX" style="width:45px">
-  <img src="https://github.com/GargantuaX.png?size=45" width="45"/>
-</a>
-<a href="https://github.com/CharlieGo88" style="width:55px">
-  <img src="https://github.com/CharlieGo88.png?size=55" width="55"/>
-</a>
-<a href="https://github.com/Bironou" style="width:55px">
-  <img src="https://github.com/Bironou.png?size=55" width="55"/>
-</a>
-<a href="https://github.com/Shackelford-Arden" style="width:55px">
-  <img src="https://github.com/Shackelford-Arden.png?size=55" width="55"/>
-</a>
-<a href="https://github.com/boostchicken" style="width:65px">
-  <img src="https://github.com/boostchicken.png?size=65" width="65"/>
-</a>
-<a href="https://github.com/iansinnott" style="width:55px">
-  <img src="https://github.com/iansinnott.png?size=55" width="55"/>
-</a>
-<span id="nav-6"></span>
-
-## Roadmap
-
-The project roadmap may be found [here](https://github.com/wailsapp/wails/discussions/1484). Please consult
-this before open up an enhancement request.

 ## Installation

-The installation instructions are on the [official website](https://wails.io/docs/gettingstarted/installation).
+Wails uses cgo to bind to the native rendering engines so a number of platform dependent libraries are needed as well as an installation of Go. The basic requirements are:

-<span id="nav-8"></span>
+- Go 1.13
+- npm
+
+### MacOS
+
+Make sure you have the xcode command line tools installed. This can be done by running:
+
+`xcode-select --install`
+
+### Linux
+
+#### Debian/Ubuntu
+
+`sudo apt install libgtk-3-dev libwebkit2gtk-4.0-dev`
+
+_Debian: 8, 9, 10_
+
+_Ubuntu: 16.04, 18.04, 19.04_
+
+_Also succesfully tested on: Zorin 15, Parrot 4.7, Linuxmint 19, Elementary 5, Kali, Neon_, Pop!_OS
+
+#### Arch Linux / ArchLabs / Ctlos Linux
+
+`sudo pacman -S webkit2gtk gtk3`
+
+_Also succesfully test on: Manjaro & ArcoLinux_
+
+#### Centos
+
+`sudo yum install webkitgtk3-devel gtk3-devel`
+
+_CentOS 6, 7_
+
+#### Fedora
+
+`sudo yum install webkit2gtk3-devel gtk3-devel`
+
+_Fedora 29, 30_
+
+#### VoidLinux & VoidLinux-musl
+
+`xbps-install gtk+3-devel webkit2gtk-devel`
+
+#### Gentoo
+
+`sudo emerge gtk+:3 webkit-gtk`
+
+### Windows
+
+Windows requires gcc and related tooling. The recommended download is from [http://tdm-gcc.tdragon.net/download](http://tdm-gcc.tdragon.net/download). Once this is installed, you are good to go.
+
+## Installation
+
+**Ensure Go modules are enabled: GO111MODULE=on and go/bin is in your PATH variable.**
+
+Installation is as simple as running the following command:
+
+<pre style='color:white'>
+go get -u github.com/wailsapp/wails/cmd/wails
+</pre>
+
+## Next Steps
+
+It is recommended at this stage to read the comprehensive documentation at [https://wails.app](https://wails.app).

 ## FAQ

- Is this an alternative to Electron?
+ * Is this an alternative to Electron?

-  Depends on your requirements. It's designed to make it easy for Go programmers to make lightweight desktop
-  applications or add a frontend to their existing applications. Wails v2 does offer native elements such as menus
-  and dialogs, so it is becoming a lightweight electron alternative.
+   Depends on your requirements. It's designed to make it easy for Go programmers to make lightweight desktop applications or add a frontend to their existing applications. Whilst Wails does not currently offer hooks into native elements such as menus, this may change in the future.

- Who is this project aimed at?
+ * Who is this project aimed at?

-  Go programmers who want to bundle an HTML/JS/CSS frontend with their applications, without resorting to creating a
-  server and opening a browser to view it.
+   Go programmers who want to bundle an HTML/JS/CSS frontend with their applications, without resorting to creating a server and opening a browser to view it.

- What's with the name?
+ * What's with the name?

-  When I saw WebView, I thought "What I really want is tooling around building a WebView app, a bit like Rails is to
-  Ruby". So initially it was a play on words (Webview on Rails). It just so happened to also be a homophone of the
-  English name for the [Country](https://en.wikipedia.org/wiki/Wales) I am from. So it stuck.
+   When I saw WebView, I thought "What I really want is tooling around building a WebView app, a bit like Rails is to Ruby". So initially it was a play on words (Webview on Rails). It just so happened to also be a homophone of the English name for the [Country](https://en.wikipedia.org/wiki/Wales) I am from. So it stuck.

-## Stargazers over time
-
-[![Stargazers over time](https://starchart.cc/wailsapp/wails.svg)](https://starchart.cc/wailsapp/wails)
-
-<span id="nav-9"></span>
-
-## Contributors
-
-The contributors list is getting too big for the readme! All the amazing people who have contributed to this
-project have their own page [here](https://wails.io/credits#contributors).
-
-<span id="nav-10"></span>
-
-## Special Mentions
+## Shoulders of Giants

 Without the following people, this project would never have existed:

- [Dustin Krysak](https://wiki.ubuntu.com/bashfulrobot) - His support and feedback has been immense. More patience than
-  you can throw a stick at (Not long now Dustin!).
- [Serge Zaitsev](https://github.com/zserge) - Creator of [Webview](https://github.com/zserge/webview) which Wails uses
-  for the windowing.
- [Byron](https://github.com/bh90210) - At times, Byron has single handedly kept this project alive. Without his
-  incredible input, we never would have got to v1.
+  * [Dustin Krysak](https://wiki.ubuntu.com/bashfulrobot) - His support and feedback has been immense. More patience than you can throw a stick at (Not long now Dustin!).
+  * [Serge Zaitsev](https://github.com/zserge) - Creator of [Webview](https://github.com/zserge/webview) which Wails uses for the windowing.
+
+And without [these people](CONTRIBUTORS.md), it wouldn't be what it is today. A huge thank you to each and every one of you!
+
+Special Mentions:
+
+  * [Byron](https://github.com/bh90210) - At times, Byron has single handedly kept this project alive. Without his incredible input, we never would have got to v1.

 This project was mainly coded to the following albums:

- [Manic Street Preachers - Resistance Is Futile](https://open.spotify.com/album/1R2rsEUqXjIvAbzM0yHrxA)
- [Manic Street Preachers - This Is My Truth, Tell Me Yours](https://open.spotify.com/album/4VzCL9kjhgGQeKCiojK1YN)
- [The Midnight - Endless Summer](https://open.spotify.com/album/4Krg8zvprquh7TVn9OxZn8)
- [Gary Newman - Savage (Songs from a Broken World)](https://open.spotify.com/album/3kMfsD07Q32HRWKRrpcexr)
- [Steve Vai - Passion & Warfare](https://open.spotify.com/album/0oL0OhrE2rYVns4IGj8h2m)
- [Ben Howard - Every Kingdom](https://open.spotify.com/album/1nJsbWm3Yy2DW1KIc1OKle)
- [Ben Howard - Noonday Dream](https://open.spotify.com/album/6astw05cTiXEc2OvyByaPs)
- [Adwaith - Melyn](https://open.spotify.com/album/2vBE40Rp60tl7rNqIZjaXM)
- [Gwidaith Hen Fran - Cedors Hen Wrach](https://open.spotify.com/album/3v2hrfNGINPLuDP0YDTOjm)
- [Metallica - Metallica](https://open.spotify.com/album/2Kh43m04B1UkVcpcRa1Zug)
- [Bloc Party - Silent Alarm](https://open.spotify.com/album/6SsIdN05HQg2GwYLfXuzLB)
- [Maxthor - Another World](https://open.spotify.com/album/3tklE2Fgw1hCIUstIwPBJF)
- [Alun Tan Lan - Y Distawrwydd](https://open.spotify.com/album/0c32OywcLpdJCWWMC6vB8v)
+  * [Manic Street Preachers - Resistance Is Futile](https://open.spotify.com/album/1R2rsEUqXjIvAbzM0yHrxA)
+  * [Manic Street Preachers - This Is My Truth, Tell Me Yours](https://open.spotify.com/album/4VzCL9kjhgGQeKCiojK1YN)
+  * [The Midnight - Endless Summer](https://open.spotify.com/album/4Krg8zvprquh7TVn9OxZn8)
+  * [Gary Newman - Savage (Songs from a Broken World)](https://open.spotify.com/album/3kMfsD07Q32HRWKRrpcexr)
+  * [Steve Vai - Passion & Warfare](https://open.spotify.com/album/0oL0OhrE2rYVns4IGj8h2m)
+  * [Ben Howard - Every Kingdom](https://open.spotify.com/album/1nJsbWm3Yy2DW1KIc1OKle)
+  * [Ben Howard - Noonday Dream](https://open.spotify.com/album/6astw05cTiXEc2OvyByaPs)
+  * [Adwaith - Melyn](https://open.spotify.com/album/2vBE40Rp60tl7rNqIZjaXM)
+  * [Gwidaith Hen Fran - Cedors Hen Wrach](https://open.spotify.com/album/3v2hrfNGINPLuDP0YDTOjm)
+  * [Metallica - Metallica](https://open.spotify.com/album/2Kh43m04B1UkVcpcRa1Zug)
+  * [Bloc Party - Silent Alarm](https://open.spotify.com/album/6SsIdN05HQg2GwYLfXuzLB)
+  * [Maxthor - Another World](https://open.spotify.com/album/3tklE2Fgw1hCIUstIwPBJF)
+  * [Alun Tan Lan - Y Distawrwydd](https://open.spotify.com/album/0c32OywcLpdJCWWMC6vB8v)

-<span id="nav-11"></span>
+## Licensing

-## Special Thanks
+[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fwailsapp%2Fwails.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fwailsapp%2Fwails?ref=badge_large)

-<p align="center" style="text-align: center">
-   <a href="https://pace.dev"><img src="/assets/images/pace.jpeg"/></a><br/>
-   A <i>huge</i> thanks to <a href="https://pace.dev">Pace</a> for sponsoring the project and helping the efforts to get Wails ported to Apple Silicon!<br/><br/>
-   If you are looking for a Project Management tool that's powerful but quick and easy to use, check them out!<br/><br/>
-</p>
+## Special Thank You

 <p align="center" style="text-align: center">
   A special thank you to JetBrains for donating licenses to us!<br/><br/>
   Please click the logo to let them know your appreciation!<br/><br/>
-   <a href="https://www.jetbrains.com?from=Wails"><img src="/assets/images/jetbrains-grayscale.png" width="30%"></a>
+   <a href="https://www.jetbrains.com?from=Wails"><img src="jetbrains-grayscale.png" width="30%"></a>
 </p>
@@ -2,6 +2,7 @@ package wails

 import (
 	"os"
+	"runtime"
 	"syscall"

 	"github.com/syossan27/tebata"
@@ -116,6 +117,11 @@ func (a *App) start() error {
 		return err
 	}

+	// Enable console for Windows debug builds
+	if runtime.GOOS == "windows" && BuildMode == cmd.BuildModeDebug {
+		a.renderer.EnableConsole()
+	}
+
 	// Start signal handler
 	t := tebata.New(os.Interrupt, os.Kill, syscall.SIGTERM, syscall.SIGINT, syscall.SIGKILL)
 	t.Reserve(func() {
--- a/Show More
+++ b/Show More