github.com/secoba/wails/v2@v2.6.4/README.md (about)

     1  <p align="center" style="text-align: center">
     2    <img src="../assets/images/logo-universal.png" width="55%"><br/>
     3  </p>
     4  
     5  <p align="center">
     6    Build desktop applications using Go & Web Technologies.
     7    <br/>
     8    <br/>
     9    <a href="https://github.com/wailsapp/wails/blob/master/LICENSE">
    10      <img alt="GitHub" src="https://img.shields.io/github/license/wailsapp/wails"/>
    11    </a>
    12    <a href="https://goreportcard.com/report/github.com/wailsapp/wails">
    13      <img src="https://goreportcard.com/badge/github.com/wailsapp/wails" />
    14    </a>
    15    <a href="https://pkg.go.dev/github.com/wailsapp/wails">
    16      <img src="https://pkg.go.dev/badge/github.com/wailsapp/wails.svg" alt="Go Reference"/>
    17    </a>
    18    <a href="https://github.com/wailsapp/wails/issues">
    19      <img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat" alt="CodeFactor" />
    20    </a>
    21    <a href="https://app.fossa.com/projects/git%2Bgithub.com%2Fwailsapp%2Fwails?ref=badge_shield" alt="FOSSA Status">
    22      <img src="https://app.fossa.com/api/projects/git%2Bgithub.com%2Fwailsapp%2Fwails.svg?type=shield" />
    23    </a>
    24    <a href="https://github.com/avelino/awesome-go" rel="nofollow">
    25      <img src="https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg" alt="Awesome" />
    26    </a>
    27    <br/>
    28    <a href="https://github.com/wailsapp/wails/actions/workflows/build.yml" rel="nofollow">
    29      <img src="https://img.shields.io/github/workflow/status/wailsapp/wails/Build?logo=github" alt="Build" />
    30    </a>
    31    <a href="https://github.com/wailsapp/wails/tags" rel="nofollow">
    32      <img alt="GitHub tag (latest SemVer pre-release)" src="https://img.shields.io/github/v/tag/wailsapp/wails?include_prereleases&label=version"/>
    33    </a>
    34  </p>
    35  
    36  <div align="center">
    37  <strong>
    38  <samp>
    39  
    40  [English](README.md) · [简体中文](README.zh-Hans.md) · [日本語](README.ja.md)
    41  
    42  </samp>
    43  </strong>
    44  </div>
    45  
    46  ## Table of Contents
    47  
    48  <details>
    49    <summary>Click me to Open/Close the directory listing</summary>
    50  
    51  - [Table of Contents](#table-of-contents)
    52  - [Introduction](#introduction)
    53    - [Roadmap](#roadmap)
    54  - [Features](#features)
    55  - [Sponsors](#sponsors)
    56  - [Getting Started](#getting-started)
    57  - [FAQ](#faq)
    58  - [Contributors](#contributors)
    59  - [License](#license)
    60  
    61  </details>
    62  
    63  ## Introduction
    64  
    65  The traditional method of providing web interfaces to Go programs is via a built-in web server. Wails offers a different
    66  approach: it provides the ability to wrap both Go code and a web frontend into a single binary. Tools are provided to
    67  make this easy for you by handling project creation, compilation and bundling. All you have to do is get creative!
    68  
    69  ## Features
    70  
    71  - Use standard Go for the backend
    72  - Use any frontend technology you are already familiar with to build your UI
    73  - Quickly create rich frontends for your Go programs using pre-built templates
    74  - Easily call Go methods from Javascript
    75  - Auto-generated Typescript definitions for your Go structs and methods
    76  - Native Dialogs & Menus
    77  - Native Dark / Light mode support
    78  - Supports modern translucency and "frosted window" effects
    79  - Unified eventing system between Go and Javascript
    80  - Powerful cli tool to quickly generate and build your projects
    81  - Multiplatform
    82  - Uses native rendering engines - _no embedded browser_!
    83  
    84  ### Roadmap
    85  
    86  The project roadmap may be found [here](https://github.com/wailsapp/wails/discussions/1484). Please consult
    87  this before open up an enhancement request.
    88  
    89  ## Sponsors
    90  
    91  This project is supported by these kind people / companies:
    92  
    93  <a href="https://github.com/sponsors/leaanthony" style="width:100px;">
    94    <img src="../website/static/img/silver%20sponsor.webp" width="100"/>
    95  </a>
    96  <a href="https://github.com/selvindev" style="width:100px;">
    97    <img src="https://github.com/selvindev.png?size=100" width="100"/>
    98  </a>
    99  <br/>
   100  <br/>
   101  <a href="https://github.com/sponsors/leaanthony" style="width:100px;">
   102    <img src="../website/static/img/bronze%20sponsor.webp" width="100"/>
   103  </a>
   104  
   105  <a href="https://github.com/codydbentley" style="width:100px">
   106    <img src="https://github.com/codydbentley.png?size=100" width="100"/>
   107  </a>
   108  <a href="https://www.easywebadv.it/" style="width:100px">
   109    <img src="../website/static/img/easyweb.png" width="100"/>
   110  </a>
   111  <br/>
   112  <br/>
   113  <a href="https://github.com/matryer" style="width:100px">
   114    <img src="https://github.com/matryer.png" width="100"/>
   115  </a>
   116  <a href="https://github.com/tc-hib" style="width:55px">
   117   <img src="https://github.com/tc-hib.png?size=55" width="55"/>
   118  </a>
   119  <a href="https://github.com/picatz" style="width:50px">
   120    <img src="https://github.com/picatz.png?size=50" width="50"/>
   121  </a>
   122  <a href="https://github.com/tylertravisty" style="width:50px">
   123    <img src="https://github.com/tylertravisty.png?size=50" width="50"/>
   124  </a>
   125  <a href="https://github.com/akhudek" style="width:50px">
   126    <img src="https://github.com/akhudek.png?size=50" width="50"/>
   127  </a>
   128  <a href="https://github.com/trea" style="width:50px">
   129    <img src="https://github.com/trea.png?size=50" width="50"/>
   130  </a>
   131  <a href="https://github.com/fcjr" style="width:55px">
   132    <img src="https://github.com/fcjr.png?size=55" width="55"/>
   133  </a>
   134  <a href="https://github.com/nickarellano" style="width:60px">
   135    <img src="https://github.com/nickarellano.png?size=60" width="60"/>
   136  </a>
   137  <a href="https://github.com/bglw" style="width:65px">
   138    <img src="https://github.com/bglw.png?size=65" width="65"/>
   139  </a>
   140  <a href="https://github.com/marcus-crane" style="width:65px">
   141    <img src="https://github.com/marcus-crane.png?size=65" width="65"/>
   142  </a>
   143  <a href="https://github.com/bbergshaven" style="width:45px">
   144    <img src="https://github.com/bbergshaven.png?size=45" width="45"/>
   145  </a>
   146  <a href="https://github.com/ilgityildirim" style="width:50px">
   147    <img src="https://github.com/ilgityildirim.png?size=50" width="50"/>
   148  </a>
   149  <a href="https://github.com/questrail" style="width:50px">
   150    <img src="https://github.com/questrail.png?size=50" width="50"/>
   151  </a>
   152  <a href="https://github.com/DonTomato" style="width:45px">
   153    <img src="https://github.com/DonTomato.png?size=45" width="45"/>
   154  </a>
   155  <a href="https://github.com/taigrr" style="width:55px">
   156    <img src="https://github.com/taigrr.png?size=55" width="55"/>
   157  </a>
   158  <a href="https://github.com/charlie-dee" style="width:55px">
   159    <img src="https://github.com/charlie-dee.png?size=55" width="55"/>
   160  </a>
   161  <a href="https://github.com/michaelolson1996" style="width:55px">
   162    <img src="https://github.com/michaelolson1996.png?size=55" width="55"/>
   163  </a>
   164  <a href="https://github.com/GargantuaX" style="width:45px">
   165    <img src="https://github.com/GargantuaX.png?size=45" width="45"/>
   166  </a>
   167  <a href="https://github.com/CharlieGo88" style="width:55px">
   168    <img src="https://github.com/CharlieGo88.png?size=55" width="55"/>
   169  </a>
   170  <a href="https://github.com/Shackelford-Arden" style="width:55px">
   171    <img src="https://github.com/Shackelford-Arden.png?size=55" width="55"/>
   172  </a>
   173  <a href="https://github.com/boostchicken" style="width:65px">
   174    <img src="https://github.com/boostchicken.png?size=65" width="65"/>
   175  </a>
   176  <a href="https://github.com/iansinnott" style="width:55px">
   177    <img src="https://github.com/iansinnott.png?size=55" width="55"/>
   178  </a>
   179  <a href="https://github.com/Ilshidur" style="width:50px">
   180    <img src="https://github.com/Ilshidur.png?size=50" width="50"/>
   181  </a>
   182  <a href="https://github.com/KiddoV" style="width:45px">
   183    <img src="https://github.com/KiddoV.png?size=45" width="45"/>
   184  </a>
   185  
   186  ## Getting Started
   187  
   188  The installation instructions are on the [official website](https://wails.io/docs/gettingstarted/installation).
   189  
   190  ## FAQ
   191  
   192  - Is this an alternative to Electron?
   193  
   194    Depends on your requirements. It's designed to make it easy for Go programmers to make lightweight desktop
   195    applications or add a frontend to their existing applications. Wails does offer native elements such as menus
   196    and dialogs, so it could be considered a lightweight electron alternative.
   197  
   198  - Who is this project aimed at?
   199  
   200    Go programmers who want to bundle an HTML/JS/CSS frontend with their applications, without resorting to creating a
   201    server and opening a browser to view it.
   202  
   203  - What's with the name?
   204  
   205    When I saw WebView, I thought "What I really want is tooling around building a WebView app, a bit like Rails is to
   206    Ruby". So initially it was a play on words (Webview on Rails). It just so happened to also be a homophone of the
   207    English name for the [Country](https://en.wikipedia.org/wiki/Wales) I am from. So it stuck.
   208  
   209  ## Stargazers over time
   210  
   211  [![Stargazers over time](https://starchart.cc/wailsapp/wails.svg)](https://starchart.cc/wailsapp/wails)
   212  
   213  ## Contributors
   214  
   215  The contributors list is getting too big for the readme! All the amazing people who have contributed to this
   216  project have their own page [here](https://wails.io/credits#contributors).
   217  
   218  ## License
   219  
   220  [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fwailsapp%2Fwails.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fwailsapp%2Fwails?ref=badge_large)
   221  
   222  ## Inspiration
   223  
   224  This project was mainly coded to the following albums:
   225  
   226  - [Manic Street Preachers - Resistance Is Futile](https://open.spotify.com/album/1R2rsEUqXjIvAbzM0yHrxA)
   227  - [Manic Street Preachers - This Is My Truth, Tell Me Yours](https://open.spotify.com/album/4VzCL9kjhgGQeKCiojK1YN)
   228  - [The Midnight - Endless Summer](https://open.spotify.com/album/4Krg8zvprquh7TVn9OxZn8)
   229  - [Gary Newman - Savage (Songs from a Broken World)](https://open.spotify.com/album/3kMfsD07Q32HRWKRrpcexr)
   230  - [Steve Vai - Passion & Warfare](https://open.spotify.com/album/0oL0OhrE2rYVns4IGj8h2m)
   231  - [Ben Howard - Every Kingdom](https://open.spotify.com/album/1nJsbWm3Yy2DW1KIc1OKle)
   232  - [Ben Howard - Noonday Dream](https://open.spotify.com/album/6astw05cTiXEc2OvyByaPs)
   233  - [Adwaith - Melyn](https://open.spotify.com/album/2vBE40Rp60tl7rNqIZjaXM)
   234  - [Gwidaith Hen Fran - Cedors Hen Wrach](https://open.spotify.com/album/3v2hrfNGINPLuDP0YDTOjm)
   235  - [Metallica - Metallica](https://open.spotify.com/album/2Kh43m04B1UkVcpcRa1Zug)
   236  - [Bloc Party - Silent Alarm](https://open.spotify.com/album/6SsIdN05HQg2GwYLfXuzLB)
   237  - [Maxthor - Another World](https://open.spotify.com/album/3tklE2Fgw1hCIUstIwPBJF)
   238  - [Alun Tan Lan - Y Distawrwydd](https://open.spotify.com/album/0c32OywcLpdJCWWMC6vB8v)