.app/Contents/info.plist`
-and check if the data is valid, EG check the binary name is correct. To persist the changes, copy the file back to
-the `build/darwin` directory.
-
-## Cannot call backend method from frontend with variadic arguments
-
-If you have a backend method defined with variadic parameters, eg:
-
-```go
-func (a *App) TestFunc(msg string, args ...interface{}) error {
- // Code
-}
-```
-
-calling this method from the frontend like this will fail:
-
-```js
-var msg = "Hello: ";
-var args = ["Go", "JS"];
-window.go.main.App.TestFunc(msg, ...args)
- .then((result) => {
- //do things here
- })
- .catch((error) => {
- //handle error
- });
-```
-
-Workaround:
-
-```js
-var msg = "Hello ";
-var args = ["Go", "JS"];
-window.go.main.App.TestFunc(msg, args)
- .then((result) => {
- //without the 3 dots
- //do things here
- })
- .catch((error) => {
- //handle error
- });
-```
-
-Credit: https://github.com/wailsapp/wails/issues/1186
-
-## I'm having getting proxy errors when trying to install Wails
-
-If you are getting errors like this:
-
-```
-"https://proxy.golang.org/github.com/wailsapp/wails/cmd/wails/@v/list": dial tcp 172.217.163.49:443: connectex: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.
-```
-
-it's probably because the official Go Proxy is being blocked (Users in China have reported this).
-The solution is to set up the proxy manually, eg:
-
-```
-go env -w GO111MODULE=on
-go env -w GOPROXY=https://goproxy.cn,direct
-```
-
-Source: https://github.com/wailsapp/wails/issues/1233
-
-## The generated TypeScript doesn't have the correct types
-
-Sometimes the generated TypeScript doesn't have the correct types. To mitigate this,
-it is possible to specify what types should be generated using the `ts_type` struct tag. For
-more details, please read [this](https://github.com/tkrajina/typescriptify-golang-structs#custom-types).
-
-## When I navigate away from `index.html`, I am unable to call methods on the frontend
-
-If you navigate away from `index.html` to a new html file, the context will be lost. This can be fixed by adding
-the following imports to the `` section of any new page you navigate to:
-
-```html
-
-
-
-
-```
-
-Source: https://github.com/wailsapp/wails/discussions/1512
-
-## I get `too many open files` errors on my Mac when I run `wails dev`
-
-By default, macOS will only allow you to open a maximum of 256 files. This can affect the `wails dev` command.
-This limit can be increased by running: `ulimit -n 1024` in the terminal.
-
-FSNotify is [looking to move to Apple's fsevents](https://github.com/fsnotify/fsnotify/issues/11) for Mac.
-If this isn't completed soon, we will create our own implementation, tracked [here](https://github.com/wailsapp/wails/issues/1733).
-
-## My Mac app gives me weird compilation errors
-
-A few users have reported seeing compilation errors such as the following:
-
-```shell
-# github.com/wailsapp/wails/v2/internal/frontend/desktop/darwin
-In file included from ../../pkg/mod/github.com/wailsapp/wails/v2@v2.0.0-beta.44.2/internal/frontend/desktop/darwin/callbacks.go:9:
-In file included from /Library/Developer/CommandLineTools/SDKs/MacOSX12.1.sdk/System/Library/Frameworks/Foundation.framework/Headers/Foundation.h:12:
-/Library/Developer/CommandLineTools/SDKs/MacOSX12.1.sdk/System/Library/Frameworks/Foundation.framework/Headers/NSBundle.h:91:143: error: function does not return NSString
-- (NSAttributedString *)localizedAttributedStringForKey:(NSString *)key value:(nullable NSString *)value table:(nullable NSString *)tableName NS_FORMAT_ARGUMENT(1) NS_REFINED_FOR_SWIFT API_AVAILABLE(macos(12.0), ios(15.0), watchos(8.0), tvos(15.0));
- ~~~~~~~~~~~~~~ ^ ~
-/Library/Developer/CommandLineTools/SDKs/MacOSX12.1.sdk/System/Library/Frameworks/Foundation.framework/Headers/NSObjCRuntime.h:103:48: note: expanded from macro 'NS_FORMAT_ARGUMENT'
- #define NS_FORMAT_ARGUMENT(A) __attribute__ ((format_arg(A)))
-```
-
-This is _normally_ due to a mismatch with the OS version you are running and the version of the XCode Command Line Tools
-installed. If you see an error like this, try upgrading your XCode Command Line Tools to the latest version.
-
-If reinstalling Xcode Command Tools still fails, you can check the path where the toolkit is located using:
-
-`xcode-select -p`
-
-If `/Applications/Xcode.app/Contents/Developer` is displayed, run `sudo xcode-select --switch /Library/Developer/CommandLineTools`
-
-Sources: https://github.com/wailsapp/wails/issues/1806 and https://github.com/wailsapp/wails/issues/1140#issuecomment-1290446496
-
---
-
-## Cannot start service: Host version "x.x.x does not match binary version "x.x.x"
-
-It's preferable to add `frontend/node_modules` and `frontend/package-lock.json` to your `.gitignore`. Otherwise when opening your repository on another machine
-that may have different versions of Node installed, you may not be able to run your application.
-
-If this does happen, simply delete `frontend/node_modules` and `frontend/package-lock.json` and run your `wails build` or `wails dev` command again.
-
-## Build process stuck on "Generating bindings"
-
-Bindings generation process runs your application in a special mode. If application, intentionally or unintentionally, contains an endless loop (i.e. not exiting after `wails.Run()` finished), this can lead to build process stuck on the stage of bindings generation. Please make sure your code exits properly.
diff --git a/website/versioned_docs/version-v2.7.0/appendix/_category_.json b/website/versioned_docs/version-v2.7.0/appendix/_category_.json
new file mode 100644
index 00000000000..83af4ca28fd
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/appendix/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "Appendix",
+ "position": 70
+}
diff --git a/website/versioned_docs/version-v2.7.0/community/_category_.json b/website/versioned_docs/version-v2.7.0/community/_category_.json
new file mode 100644
index 00000000000..524986e1e49
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/community/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "Community",
+ "position": 50
+}
diff --git a/website/versioned_docs/version-v2.5.0/community/links.mdx b/website/versioned_docs/version-v2.7.0/community/links.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/community/links.mdx
rename to website/versioned_docs/version-v2.7.0/community/links.mdx
diff --git a/website/versioned_docs/version-v2.7.0/community/showcase/_category_.json b/website/versioned_docs/version-v2.7.0/community/showcase/_category_.json
new file mode 100644
index 00000000000..276e283b71f
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/community/showcase/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "Showcase",
+ "position": 1
+}
diff --git a/website/versioned_docs/version-v2.7.0/community/showcase/bulletinboard.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/bulletinboard.mdx
new file mode 100644
index 00000000000..37be75135ed
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/community/showcase/bulletinboard.mdx
@@ -0,0 +1,10 @@
+# BulletinBoard
+
+```mdx-code-block
+
+ ![]({require("@site/static/img/showcase/bboard.webp").default})
+
+
+```
+
+The [BulletinBoard](https://github.com/raguay/BulletinBoard) application is a versital message board for static messages or dialogs to get information from the user for a script. It has a TUI for creating new dialogs that can latter be used to get information from the user. It's design is to stay running on your system and show the information as needed and then hide away. I have a process for watching a file on my system and sending the contents to BulletinBoard when changed. It works great with my workflows. There is also an [Alfred workflow](https://github.com/raguay/MyAlfred/blob/master/Alfred%205/EmailIt.alfredworkflow) for sending information to the program. The workflow is also for working with [EmailIt](https://github.com/raguay/EmailIt).
diff --git a/website/versioned_docs/version-v2.7.0/community/showcase/emailit.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/emailit.mdx
new file mode 100644
index 00000000000..c1817b70fff
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/community/showcase/emailit.mdx
@@ -0,0 +1,10 @@
+# EmailIt
+
+```mdx-code-block
+
+ ![]({require("@site/static/img/showcase/emailit.webp").default})
+
+
+```
+
+[EmailIt](https://github.com/raguay/EmailIt/) is a Wails 2 program that is a markdown based email sender only with nine notepads, scripts to manipulate the text, and templates. It also has a scripts terminal to run scripts in EmailIt on files in your system. The scripts and templates can be used from the commandline itself or with the Alfred, Keyboard Maestro, Dropzone, or PopClip extensions. It also supports scripts and themes downloaded form GitHub. Documentation is not complete, but the programs works. It’s built using Wails2 and Svelte, and the download is a universal macOS application.
diff --git a/website/versioned_docs/version-v2.5.0/community/showcase/encrypteasy.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/encrypteasy.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/community/showcase/encrypteasy.mdx
rename to website/versioned_docs/version-v2.7.0/community/showcase/encrypteasy.mdx
diff --git a/website/versioned_docs/version-v2.5.0/community/showcase/filehound.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/filehound.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/community/showcase/filehound.mdx
rename to website/versioned_docs/version-v2.7.0/community/showcase/filehound.mdx
diff --git a/website/versioned_docs/version-v2.5.0/community/showcase/hiposter.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/hiposter.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/community/showcase/hiposter.mdx
rename to website/versioned_docs/version-v2.7.0/community/showcase/hiposter.mdx
diff --git a/website/versioned_docs/version-v2.5.0/community/showcase/minecraftupdater.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/minecraftupdater.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/community/showcase/minecraftupdater.mdx
rename to website/versioned_docs/version-v2.7.0/community/showcase/minecraftupdater.mdx
diff --git a/website/versioned_docs/version-v2.5.0/community/showcase/modalfilemanager.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/modalfilemanager.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/community/showcase/modalfilemanager.mdx
rename to website/versioned_docs/version-v2.7.0/community/showcase/modalfilemanager.mdx
diff --git a/website/versioned_docs/version-v2.5.0/community/showcase/mollywallet.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/mollywallet.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/community/showcase/mollywallet.mdx
rename to website/versioned_docs/version-v2.7.0/community/showcase/mollywallet.mdx
diff --git a/website/versioned_docs/version-v2.7.0/community/showcase/october.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/october.mdx
new file mode 100644
index 00000000000..66d634dc519
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/community/showcase/october.mdx
@@ -0,0 +1,14 @@
+# October
+
+```mdx-code-block
+
+ ![]({require("@site/static/img/showcase/october.webp").default})
+
+
+```
+
+[October](https://october.utf9k.net) is a small Wails application that makes it really easy to extract highlights from [Kobo eReaders](https://en.wikipedia.org/wiki/Kobo_eReader) and then forward them to [Readwise](https://readwise.io).
+
+It has a relatively small scope with all platform versions weighing in under 10MB, and that's without enabling [UPX compression](https://upx.github.io/)!
+
+In contrast, the author's previous attempts with Electron quickly bloated to several hundred megabytes.
diff --git a/website/versioned_docs/version-v2.5.0/community/showcase/optimus.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/optimus.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/community/showcase/optimus.mdx
rename to website/versioned_docs/version-v2.7.0/community/showcase/optimus.mdx
diff --git a/website/versioned_docs/version-v2.5.0/community/showcase/portfall.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/portfall.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/community/showcase/portfall.mdx
rename to website/versioned_docs/version-v2.7.0/community/showcase/portfall.mdx
diff --git a/website/versioned_docs/version-v2.7.0/community/showcase/restic-browser.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/restic-browser.mdx
new file mode 100644
index 00000000000..3646384ecad
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/community/showcase/restic-browser.mdx
@@ -0,0 +1,12 @@
+# Restic Browser
+
+```mdx-code-block
+
+ ![]({require("@site/static/img/showcase/restic-browser-2.png").default})
+
+
+```
+
+[Restic-Browser](https://github.com/emuell/restic-browser) - A simple, cross-platform [restic](https://github.com/restic/restic) backup GUI for browsing and restoring restic repositories.
diff --git a/website/versioned_docs/version-v2.7.0/community/showcase/riftshare.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/riftshare.mdx
new file mode 100644
index 00000000000..9928b478576
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/community/showcase/riftshare.mdx
@@ -0,0 +1,21 @@
+# RiftShare
+
+```mdx-code-block
+
+ ![]({require("@site/static/img/showcase/riftshare-main.webp").default})
+
+
+```
+
+Easy, Secure, and Free file sharing for everyone. Learn more at [Riftshare.app](https://riftshare.app)
+
+## Features
+
+- Easy secure file sharing between computers both in the local network and through the internet
+- Supports sending files or directories securely through the [magic wormhole protocol](https://magic-wormhole.readthedocs.io/en/latest/)
+- Compatible with all other apps using magic wormhole (magic-wormhole or wormhole-william CLI, wormhole-gui, etc.)
+- Automatic zipping of multiple selected files to send at once
+- Full animations, progress bar, and cancellation support for sending and receiving
+- Native OS File Selection
+- Open files in one click once received
+- Auto Update - don't worry about having the latest release!
diff --git a/website/versioned_docs/version-v2.7.0/community/showcase/scriptbar.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/scriptbar.mdx
new file mode 100644
index 00000000000..3e41eb32abf
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/community/showcase/scriptbar.mdx
@@ -0,0 +1,10 @@
+# ScriptBar
+
+```mdx-code-block
+
+ ![]({require("@site/static/img/showcase/scriptbar.webp").default})
+
+
+```
+
+[ScriptBar](https://GitHub.com/raguay/ScriptBarApp) is a program to show the output of scripts or [Node-Red](https://nodered.org) server. It runs scripts defined in EmailIt program and shows the output. Scripts from xBar or TextBar can be used, but currently on the TextBar scripts work well. It also displays the output of scripts on your system. ScriptBar doesn't put them in the menubar, but has them all in a convient window for easy viewing. You can have multiple tabs to have many different things show. You can also keep the links to your most visited web sites.
diff --git a/website/versioned_docs/version-v2.7.0/community/showcase/snippetexpander.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/snippetexpander.mdx
new file mode 100644
index 00000000000..1f9fb615796
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/community/showcase/snippetexpander.mdx
@@ -0,0 +1,27 @@
+# Snippet Expander
+
+```mdx-code-block
+
+ ![]({require("@site/static/img/showcase/snippetexpandergui-select-snippet.png").default})
+
+ Screenshot of Snippet Expander's Select Snippet window
+
+
+ ![]({require("@site/static/img/showcase/snippetexpandergui-add-snippet.png").default})
+
+ Screenshot of Snippet Expander's Add Snippet screen
+
+
+ ![]({require("@site/static/img/showcase/snippetexpandergui-search-and-paste.png").default})
+
+ Screenshot of Snippet Expander's Search & Paste window
+
+```
+
+[Snippet Expander](https://snippetexpander.org) is "Your little expandable text snippets helper", for Linux.
+
+Snippet Expander comprises of a GUI application built with Wails for managing snippets and settings, with a Search & Paste window mode for quickly selecting and pasting a snippet.
+
+The Wails based GUI, go-lang CLI and vala-lang auto expander daemon all communicate with a go-lang daemon via D-Bus. The daemon does the majority of the work, managing the database of snippets and common settings, and providing services for expanding and pasting snippets etc.
+
+Check out the [source code](https://git.sr.ht/~ianmjones/snippetexpander/tree/trunk/item/cmd/snippetexpandergui/app.go#L38) to see how the Wails app sends messages from the UI to the backend that are then sent to the daemon, and subscribes to a D-Bus event to monitor changes to snippets via another instance of the app or CLI and show them instantly in the UI via a Wails event.
diff --git a/website/versioned_docs/version-v2.7.0/community/showcase/surge.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/surge.mdx
new file mode 100644
index 00000000000..c3b3fb4c06d
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/community/showcase/surge.mdx
@@ -0,0 +1,10 @@
+# Surge
+
+```mdx-code-block
+
+ ![]({require("@site/static/img/showcase/surge.png").default})
+
+
+```
+
+[Surge](https://getsurge.io/) is a p2p filesharing app designed to utilize blockchain technologies to enable 100% anonymous file transfers. Surge is end-to-end encrypted, decentralized and open source.
diff --git a/website/versioned_docs/version-v2.7.0/community/showcase/tinyrdm.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/tinyrdm.mdx
new file mode 100644
index 00000000000..cd9cec8b309
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/community/showcase/tinyrdm.mdx
@@ -0,0 +1,10 @@
+# Tiny RDM
+
+```mdx-code-block
+
+ ![]({require("@site/static/img/showcase/tiny-rdm.webp").default})
+
+
+```
+
+The [Tiny RDM](https://redis.tinycraft.cc/) application is an open-source, modern lightweight Redis GUI. It has a beautful UI, intuitive Redis database management, and compatible with Windows, Mac, and Linux. It provides visual key-value data operations, supports various data decoding and viewing options, built-in console for executing commands, slow log queries and more.
diff --git a/website/versioned_docs/version-v2.7.0/community/showcase/wally.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/wally.mdx
new file mode 100644
index 00000000000..7408aa5854f
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/community/showcase/wally.mdx
@@ -0,0 +1,10 @@
+# Wally
+
+```mdx-code-block
+
+ ![]({require("@site/static/img/showcase/wally.webp").default})
+
+
+```
+
+[Wally](https://ergodox-ez.com/pages/wally) is the official firmware flasher for [Ergodox](https://ergodox-ez.com/) keyboards. It looks great and is a fantastic example of what you can achieve with Wails: the ability to combine the power of Go and the rich graphical tools of the web development world.
diff --git a/website/versioned_docs/version-v2.5.0/community/showcase/warmine.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/warmine.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/community/showcase/warmine.mdx
rename to website/versioned_docs/version-v2.7.0/community/showcase/warmine.mdx
diff --git a/website/versioned_docs/version-v2.5.0/community/showcase/wombat.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/wombat.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/community/showcase/wombat.mdx
rename to website/versioned_docs/version-v2.7.0/community/showcase/wombat.mdx
diff --git a/website/versioned_docs/version-v2.7.0/community/showcase/ytd.mdx b/website/versioned_docs/version-v2.7.0/community/showcase/ytd.mdx
new file mode 100644
index 00000000000..5db428f722c
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/community/showcase/ytd.mdx
@@ -0,0 +1,10 @@
+# Ytd
+
+```mdx-code-block
+
+ ![]({require("@site/static/img/showcase/ytd.webp").default})
+
+
+```
+
+[Ytd](https://github.com/marcio199226/ytd/tree/v2-wails) is an app for downloading tracks from youtube, creating offline playlists and share them with your friends, your friends will be able to playback your playlists or download them for offline listening, has an built-in player.
diff --git a/website/versioned_docs/version-v2.5.0/community/templates.mdx b/website/versioned_docs/version-v2.7.0/community/templates.mdx
similarity index 84%
rename from website/versioned_docs/version-v2.5.0/community/templates.mdx
rename to website/versioned_docs/version-v2.7.0/community/templates.mdx
index 1ac9ef5262c..98726c60aff 100644
--- a/website/versioned_docs/version-v2.5.0/community/templates.mdx
+++ b/website/versioned_docs/version-v2.7.0/community/templates.mdx
@@ -40,18 +40,17 @@ If you are unsure about a template, inspect `package.json` and `wails.json` for
- [wails-react-template](https://github.com/AlienRecall/wails-react-template) - A template using reactjs
- [wails-react-template](https://github.com/flin7/wails-react-template) - A minimal template for React that supports live development
- [wails-template-nextjs](https://github.com/LGiki/wails-template-nextjs) - A template using Next.js and TypeScript
+- [wails-template-nextjs-app-router](https://github.com/thisisvk-in/wails-template-nextjs-app-router) - A template using Next.js and TypeScript with App router
- [wails-vite-react-ts-tailwind-template](https://github.com/hotafrika/wails-vite-react-ts-tailwind-template) - A template for React + TypeScript + Vite + TailwindCSS
+- [wails-vite-react-ts-tailwind-shadcnui-template](https://github.com/Mahcks/wails-vite-react-tailwind-shadcnui-ts) - A template with Vite, React, TypeScript, TailwindCSS, and shadcn/ui
## Svelte
- [wails-svelte-template](https://github.com/raitonoberu/wails-svelte-template) - A template using Svelte
- [wails-vite-svelte-template](https://github.com/BillBuilt/wails-vite-svelte-template) - A template using Svelte and Vite
- [wails-vite-svelte-tailwind-template](https://github.com/BillBuilt/wails-vite-svelte-tailwind-template) - A template using Svelte and Vite with TailwindCSS v3
-
-## SvelteKit
-
+- [wails-svelte-tailwind-vite-template](https://github.com/PylotLight/wails-vite-svelte-tailwind-template/tree/master) - An updated template using Svelte v4.2.0 and Vite with TailwindCSS v3.3.3
- [wails-sveltekit-template](https://github.com/h8gi/wails-sveltekit-template) - A template using SvelteKit
-- [wails-sveltekit-ts](https://github.com/haukened/wails-sveltekit-ts) - A template using SvelteKit + Typescript
## Solid
@@ -63,10 +62,10 @@ If you are unsure about a template, inspect `package.json` and `wails.json` for
- [wails-elm-template](https://github.com/benjamin-thomas/wails-elm-template) - Develop your GUI app with functional programming and a **snappy** hot-reload setup :tada: :rocket:
- [wails-template-elm-tailwind](https://github.com/rnice01/wails-template-elm-tailwind) - Combine the powers :muscle: of Elm + Tailwind CSS + Wails! Hot reloading supported.
-## Pure JavaScript (Vanilla)
+## HTMX
-- [wails-pure-js-template](https://github.com/KiddoV/wails-pure-js-template) - A template with nothing but just basic JavaScript, HTML, and CSS
+- [wails-htmx-templ-chi-tailwind](https://github.com/PylotLight/wails-hmtx-templ-template) - Use a unique combination of pure htmx for interactivity plus templ for creating components and forms
-## Qwik
+## Pure JavaScript (Vanilla)
-- [wails-qwik-template](https://github.com/LazyClicks/wails-qwik-template) - A template using Qwik
+- [wails-pure-js-template](https://github.com/KiddoV/wails-pure-js-template) - A template with nothing but just basic JavaScript, HTML, and CSS
diff --git a/website/versioned_docs/version-v2.7.0/gettingstarted/_category_.json b/website/versioned_docs/version-v2.7.0/gettingstarted/_category_.json
new file mode 100644
index 00000000000..597b920dff9
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/gettingstarted/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "Getting Started",
+ "position": 10
+}
diff --git a/website/versioned_docs/version-v2.5.0/gettingstarted/building.mdx b/website/versioned_docs/version-v2.7.0/gettingstarted/building.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/gettingstarted/building.mdx
rename to website/versioned_docs/version-v2.7.0/gettingstarted/building.mdx
diff --git a/website/versioned_docs/version-v2.5.0/gettingstarted/development.mdx b/website/versioned_docs/version-v2.7.0/gettingstarted/development.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/gettingstarted/development.mdx
rename to website/versioned_docs/version-v2.7.0/gettingstarted/development.mdx
diff --git a/website/versioned_docs/version-v2.5.0/gettingstarted/firstproject.mdx b/website/versioned_docs/version-v2.7.0/gettingstarted/firstproject.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/gettingstarted/firstproject.mdx
rename to website/versioned_docs/version-v2.7.0/gettingstarted/firstproject.mdx
diff --git a/website/versioned_docs/version-v2.5.0/gettingstarted/installation.mdx b/website/versioned_docs/version-v2.7.0/gettingstarted/installation.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/gettingstarted/installation.mdx
rename to website/versioned_docs/version-v2.7.0/gettingstarted/installation.mdx
diff --git a/website/versioned_docs/version-v2.7.0/guides/_category_.json b/website/versioned_docs/version-v2.7.0/guides/_category_.json
new file mode 100644
index 00000000000..5935dad936c
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/guides/_category_.json
@@ -0,0 +1,4 @@
+{
+ "label": "Guides",
+ "position": 50
+}
diff --git a/website/versioned_docs/version-v2.5.0/guides/angular.mdx b/website/versioned_docs/version-v2.7.0/guides/angular.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/guides/angular.mdx
rename to website/versioned_docs/version-v2.7.0/guides/angular.mdx
diff --git a/website/versioned_docs/version-v2.5.0/guides/application-development.mdx b/website/versioned_docs/version-v2.7.0/guides/application-development.mdx
similarity index 87%
rename from website/versioned_docs/version-v2.5.0/guides/application-development.mdx
rename to website/versioned_docs/version-v2.7.0/guides/application-development.mdx
index 9d04fe9172d..78a6df3bcf1 100644
--- a/website/versioned_docs/version-v2.5.0/guides/application-development.mdx
+++ b/website/versioned_docs/version-v2.7.0/guides/application-development.mdx
@@ -144,6 +144,65 @@ func main() {
}
```
+Also you might want to use Enums in your structs and have models for them on frontend.
+In that case you should create array that will contain all possible enum values, instrument enum type and bind it to the app:
+
+```go {16-18} title="app.go"
+type Weekday string
+
+const (
+ Sunday Weekday = "Sunday"
+ Monday Weekday = "Monday"
+ Tuesday Weekday = "Tuesday"
+ Wednesday Weekday = "Wednesday"
+ Thursday Weekday = "Thursday"
+ Friday Weekday = "Friday"
+ Saturday Weekday = "Saturday"
+)
+
+var AllWeekdays = []struct {
+ Value Weekday
+ TSName string
+}{
+ {Sunday, "SUNDAY"},
+ {Monday, "MONDAY"},
+ {Tuesday, "TUESDAY"},
+ {Wednesday, "WEDNESDAY"},
+ {Thursday, "THURSDAY"},
+ {Friday, "FRIDAY"},
+ {Saturday, "SATURDAY"},
+}
+```
+
+In the main application configuration, the `EnumBind` key is where we can tell Wails what we want to bind enums as well:
+
+```go {11-13} title="main.go"
+func main() {
+
+ app := NewApp()
+
+ err := wails.Run(&options.App{
+ Title: "My App",
+ Width: 800,
+ Height: 600,
+ OnStartup: app.startup,
+ OnShutdown: app.shutdown,
+ Bind: []interface{}{
+ app,
+ },
+ EnumBind: []interface{}{
+ AllWeekdays,
+ },
+ })
+ if err != nil {
+ log.Fatal(err)
+ }
+}
+
+```
+
+This will add missing enums to your `model.ts` file.
+
More information on Binding can be found [here](../howdoesitwork.mdx#method-binding).
## Application Menu
diff --git a/website/versioned_docs/version-v2.7.0/guides/crossplatform-build.mdx b/website/versioned_docs/version-v2.7.0/guides/crossplatform-build.mdx
new file mode 100644
index 00000000000..a9afc616119
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/guides/crossplatform-build.mdx
@@ -0,0 +1,65 @@
+# Crossplatform build with Github Actions
+
+To build a Wails project for all the available platforms, you need to create an application build for each operating system. One effective method to achieve this is by utilizing GitHub Actions.
+
+An action that facilitates building a Wails app is available at:
+https://github.com/dAppServer/wails-build-action
+
+In case the existing action doesn't fulfill your requirements, you can select only the necessary steps from the source:
+https://github.com/dAppServer/wails-build-action/blob/main/action.yml
+
+Below is a comprehensive example that demonstrates building an app upon the creation of a new Git tag and subsequently uploading it to the Actions artifacts:
+
+```yaml
+name: Wails build
+
+on:
+ push:
+ tags:
+ # Match any new tag
+ - '*'
+
+env:
+ # Necessary for most environments as build failure can occur due to OOM issues
+ NODE_OPTIONS: "--max-old-space-size=4096"
+
+jobs:
+ build:
+ strategy:
+ # Failure in one platform build won't impact the others
+ fail-fast: false
+ matrix:
+ build:
+ - name: 'App'
+ platform: 'linux/amd64'
+ os: 'ubuntu-latest'
+ - name: 'App'
+ platform: 'windows/amd64'
+ os: 'windows-latest'
+ - name: 'App'
+ platform: 'darwin/universal'
+ os: 'macos-latest'
+
+ runs-on: ${{ matrix.build.os }}
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v2
+ with:
+ submodules: recursive
+
+ - name: Build wails
+ uses: dAppServer/wails-build-action@v2.2
+ id: build
+ with:
+ build-name: ${{ matrix.build.name }}
+ build-platform: ${{ matrix.build.platform }}
+ package: false
+ go-version: '1.20'
+```
+
+This example offers opportunities for various enhancements, including:
+- Caching dependencies
+- Code signing
+- Uploading to platforms like S3, Supbase, etc.
+- Injecting secrets as environment variables
+- Utilizing environment variables as build variables (such as version variable extracted from the current Git tag)
diff --git a/website/versioned_docs/version-v2.7.0/guides/custom-protocol-schemes.mdx b/website/versioned_docs/version-v2.7.0/guides/custom-protocol-schemes.mdx
new file mode 100644
index 00000000000..c56634f0eb0
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/guides/custom-protocol-schemes.mdx
@@ -0,0 +1,189 @@
+# Custom Protocol Scheme association
+
+Custom Protocols feature allows you to associate specific custom protocol with your app so that when users open links with this protocol,
+your app is launched to handle them. This can be particularly useful to connect your desktop app with your web app.
+In this guide, we'll walk through the steps to implement custom protocols in Wails app.
+
+
+## Set Up Custom Protocol Schemes Association:
+To set up custom protocol, you need to modify your application's wails.json file.
+In "info" section add a "protocols" section specifying the protocols your app should be associated with.
+
+For example:
+```json
+{
+ "info": {
+ "protocols": [
+ {
+ "scheme": "myapp",
+ "description": "My App Protocol",
+ "role": "Editor"
+ }
+ ]
+ }
+}
+```
+
+| Property | Description |
+|:------------|:--------------------------------------------------------------------------------------|
+| scheme | Custom Protocol scheme. e.g. myapp |
+| description | Windows-only. The description. |
+| role | macOS-only. The app’s role with respect to the type. Corresponds to CFBundleTypeRole. |
+
+## Platform Specifics:
+
+### macOS
+When you open custom protocol with your app, the system will launch your app and call the `OnUrlOpen` function in your Wails app. Example:
+```go title="main.go"
+func main() {
+ // Create application with options
+ err := wails.Run(&options.App{
+ Title: "wails-open-file",
+ Width: 1024,
+ Height: 768,
+ AssetServer: &assetserver.Options{
+ Assets: assets,
+ },
+ BackgroundColour: &options.RGBA{R: 27, G: 38, B: 54, A: 1},
+ Mac: &mac.Options{
+ OnUrlOpen: func(url string) { println(url) },
+ },
+ Bind: []interface{}{
+ app,
+ },
+ })
+
+ if err != nil {
+ println("Error:", err.Error())
+ }
+}
+```
+
+
+### Windows
+On Windows Custom Protocol Schemes is supported only with NSIS installer. During installation, the installer will create a
+registry entry for your schemes. When you open url with your app, new instance of app is launched and url is passed
+as argument to your app. To handle this you should parse command line arguments in your app. Example:
+```go title="main.go"
+func main() {
+ argsWithoutProg := os.Args[1:]
+
+ if len(argsWithoutProg) != 0 {
+ println("launchArgs", argsWithoutProg)
+ }
+}
+```
+
+You also can enable single instance lock for your app. In this case, when you open url with your app, new instance of app is not launched
+and arguments are passed to already running instance. Check single instance lock guide for details. Example:
+```go title="main.go"
+func main() {
+ // Create application with options
+ err := wails.Run(&options.App{
+ Title: "wails-open-file",
+ Width: 1024,
+ Height: 768,
+ AssetServer: &assetserver.Options{
+ Assets: assets,
+ },
+ BackgroundColour: &options.RGBA{R: 27, G: 38, B: 54, A: 1},
+ SingleInstanceLock: &options.SingleInstanceLock{
+ UniqueId: "e3984e08-28dc-4e3d-b70a-45e961589cdc",
+ OnSecondInstanceLaunch: app.onSecondInstanceLaunch,
+ },
+ Bind: []interface{}{
+ app,
+ },
+ })
+}
+```
+
+### Linux
+Currently, Wails doesn't support bundling for Linux. So, you need to create file associations manually.
+For example if you distribute your app as a .deb package, you can create file associations by adding required files in you bundle.
+You can use [nfpm](https://nfpm.goreleaser.com/) to create .deb package for your app.
+
+1. Create a .desktop file for your app and specify file associations there (note that `%u` is important in Exec). Example:
+```ini
+[Desktop Entry]
+Categories=Office
+Exec=/usr/bin/wails-open-file %u
+Icon=wails-open-file.png
+Name=wails-open-file
+Terminal=false
+Type=Application
+MimeType=x-scheme-handler/myapp;
+```
+
+2. Prepare postInstall/postRemove scripts for your package. Example:
+```sh
+# reload desktop database to load app in list of available
+update-desktop-database /usr/share/applications
+```
+3. Configure nfpm to use your scripts and files. Example:
+```yaml
+name: "wails-open-file"
+arch: "arm64"
+platform: "linux"
+version: "1.0.0"
+section: "default"
+priority: "extra"
+maintainer: "FooBarCorp "
+description: "Sample Package"
+vendor: "FooBarCorp"
+homepage: "http://example.com"
+license: "MIT"
+contents:
+- src: ../bin/wails-open-file
+ dst: /usr/bin/wails-open-file
+- src: ./main.desktop
+ dst: /usr/share/applications/wails-open-file.desktop
+- src: ../appicon.svg
+ dst: /usr/share/icons/hicolor/scalable/apps/wails-open-file.svg
+# copy icons to Yaru theme as well. For some reason Ubuntu didn't pick up fileicons from hicolor theme
+- src: ../appicon.svg
+ dst: /usr/share/icons/Yaru/scalable/apps/wails-open-file.svg
+scripts:
+ postinstall: ./postInstall.sh
+ postremove: ./postRemove.sh
+```
+6. Build your .deb package using nfpm:
+```sh
+nfpm pkg --packager deb --target .
+```
+7. Now when your package is installed, your app will be associated with custom protocol scheme. When you open url with your app,
+new instance of app is launched and file path is passed as argument to your app.
+To handle this you should parse command line arguments in your app. Example:
+```go title="main.go"
+func main() {
+ argsWithoutProg := os.Args[1:]
+
+ if len(argsWithoutProg) != 0 {
+ println("launchArgs", argsWithoutProg)
+ }
+}
+```
+
+You also can enable single instance lock for your app. In this case, when you open url with your app, new instance of app is not launched
+and arguments are passed to already running instance. Check single instance lock guide for details. Example:
+```go title="main.go"
+func main() {
+ // Create application with options
+ err := wails.Run(&options.App{
+ Title: "wails-open-file",
+ Width: 1024,
+ Height: 768,
+ AssetServer: &assetserver.Options{
+ Assets: assets,
+ },
+ BackgroundColour: &options.RGBA{R: 27, G: 38, B: 54, A: 1},
+ SingleInstanceLock: &options.SingleInstanceLock{
+ UniqueId: "e3984e08-28dc-4e3d-b70a-45e961589cdc",
+ OnSecondInstanceLaunch: app.onSecondInstanceLaunch,
+ },
+ Bind: []interface{}{
+ app,
+ },
+ })
+}
+```
diff --git a/website/versioned_docs/version-v2.5.0/guides/dynamic-assets.mdx b/website/versioned_docs/version-v2.7.0/guides/dynamic-assets.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/guides/dynamic-assets.mdx
rename to website/versioned_docs/version-v2.7.0/guides/dynamic-assets.mdx
diff --git a/website/versioned_docs/version-v2.7.0/guides/file-association.mdx b/website/versioned_docs/version-v2.7.0/guides/file-association.mdx
new file mode 100644
index 00000000000..71bbff37ead
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/guides/file-association.mdx
@@ -0,0 +1,228 @@
+# File Association
+
+File association feature allows you to associate specific file types with your app so that when users open those files,
+your app is launched to handle them. This can be particularly useful for text editors, image viewers, or any application
+that works with specific file formats. In this guide, we'll walk through the steps to implement file association in Wails app.
+
+
+## Set Up File Association:
+To set up file association, you need to modify your application's wails.json file.
+In "info" section add a "fileAssociations" section specifying the file types your app should be associated with.
+
+For example:
+```json
+{
+ "info": {
+ "fileAssociations": [
+ {
+ "ext": "wails",
+ "name": "Wails",
+ "description": "Wails Application File",
+ "iconName": "wailsFileIcon",
+ "role": "Editor"
+ },
+ {
+ "ext": "jpg",
+ "name": "JPEG",
+ "description": "Image File",
+ "iconName": "jpegFileIcon",
+ "role": "Editor"
+ }
+ ]
+ }
+}
+```
+
+| Property | Description |
+|:------------|:---------------------------------------------------------------------------------------------------------------------------------------------------|
+| ext | The extension (minus the leading period). e.g. png |
+| name | The name. e.g. PNG File |
+| iconName | The icon name without extension. Icons should be located in build folder. Proper icons will be generated from .png file for both macOS and Windows |
+| description | Windows-only. The description. It is displayed on the `Type` column on Windows Explorer. |
+| role | macOS-only. The app’s role with respect to the type. Corresponds to CFBundleTypeRole. |
+
+## Platform Specifics:
+
+### macOS
+When you open file (or files) with your app, the system will launch your app and call the `OnFileOpen` function in your Wails app. Example:
+```go title="main.go"
+func main() {
+ // Create application with options
+ err := wails.Run(&options.App{
+ Title: "wails-open-file",
+ Width: 1024,
+ Height: 768,
+ AssetServer: &assetserver.Options{
+ Assets: assets,
+ },
+ BackgroundColour: &options.RGBA{R: 27, G: 38, B: 54, A: 1},
+ Mac: &mac.Options{
+ OnFileOpen: func(filePaths []string) { println(filestring) },
+ },
+ Bind: []interface{}{
+ app,
+ },
+ })
+
+ if err != nil {
+ println("Error:", err.Error())
+ }
+}
+```
+
+
+### Windows
+On Windows file association is supported only with NSIS installer. During installation, the installer will create a
+registry entry for your file associations. When you open file with your app, new instance of app is launched and file path is passed
+as argument to your app. To handle this you should parse command line arguments in your app. Example:
+```go title="main.go"
+func main() {
+ argsWithoutProg := os.Args[1:]
+
+ if len(argsWithoutProg) != 0 {
+ println("launchArgs", argsWithoutProg)
+ }
+}
+```
+
+You also can enable single instance lock for your app. In this case, when you open file with your app, new instance of app is not launched
+and arguments are passed to already running instance. Check single instance lock guide for details. Example:
+```go title="main.go"
+func main() {
+ // Create application with options
+ err := wails.Run(&options.App{
+ Title: "wails-open-file",
+ Width: 1024,
+ Height: 768,
+ AssetServer: &assetserver.Options{
+ Assets: assets,
+ },
+ BackgroundColour: &options.RGBA{R: 27, G: 38, B: 54, A: 1},
+ SingleInstanceLock: &options.SingleInstanceLock{
+ UniqueId: "e3984e08-28dc-4e3d-b70a-45e961589cdc",
+ OnSecondInstanceLaunch: app.onSecondInstanceLaunch,
+ },
+ Bind: []interface{}{
+ app,
+ },
+ })
+}
+```
+
+### Linux
+Currently, Wails doesn't support bundling for Linux. So, you need to create file associations manually.
+For example if you distribute your app as a .deb package, you can create file associations by adding required files in you bundle.
+You can use [nfpm](https://nfpm.goreleaser.com/) to create .deb package for your app.
+
+1. Create a .desktop file for your app and specify file associations there. Example:
+```ini
+[Desktop Entry]
+Categories=Office
+Exec=/usr/bin/wails-open-file %u
+Icon=wails-open-file.png
+Name=wails-open-file
+Terminal=false
+Type=Application
+MimeType=application/x-wails;application/x-test
+```
+
+2. Create mime types file. Example:
+```xml
+
+
+
+ Wails Application File
+
+
+
+```
+
+3. Create icons for your file types. SVG icons are recommended.
+4. Prepare postInstall/postRemove scripts for your package. Example:
+```sh
+# reload mime types to register file associations
+update-mime-database /usr/share/mime
+# reload desktop database to load app in list of available
+update-desktop-database /usr/share/applications
+# update icons
+update-icon-caches /usr/share/icons/*
+```
+5. Configure nfpm to use your scripts and files. Example:
+```yaml
+name: "wails-open-file"
+arch: "arm64"
+platform: "linux"
+version: "1.0.0"
+section: "default"
+priority: "extra"
+maintainer: "FooBarCorp "
+description: "Sample Package"
+vendor: "FooBarCorp"
+homepage: "http://example.com"
+license: "MIT"
+contents:
+- src: ../bin/wails-open-file
+ dst: /usr/bin/wails-open-file
+- src: ./main.desktop
+ dst: /usr/share/applications/wails-open-file.desktop
+- src: ./application-wails-mime.xml
+ dst: /usr/share/mime/packages/application-x-wails.xml
+- src: ./application-test-mime.xml
+ dst: /usr/share/mime/packages/application-x-test.xml
+- src: ../appicon.svg
+ dst: /usr/share/icons/hicolor/scalable/apps/wails-open-file.svg
+- src: ../wailsFileIcon.svg
+ dst: /usr/share/icons/hicolor/scalable/mimetypes/application-x-wails.svg
+- src: ../testFileIcon.svg
+ dst: /usr/share/icons/hicolor/scalable/mimetypes/application-x-test.svg
+# copy icons to Yaru theme as well. For some reason Ubuntu didn't pick up fileicons from hicolor theme
+- src: ../appicon.svg
+ dst: /usr/share/icons/Yaru/scalable/apps/wails-open-file.svg
+- src: ../wailsFileIcon.svg
+ dst: /usr/share/icons/Yaru/scalable/mimetypes/application-x-wails.svg
+- src: ../testFileIcon.svg
+ dst: /usr/share/icons/Yaru/scalable/mimetypes/application-x-test.svg
+scripts:
+ postinstall: ./postInstall.sh
+ postremove: ./postRemove.sh
+```
+6. Build your .deb package using nfpm:
+```sh
+nfpm pkg --packager deb --target .
+```
+7. Now when your package is installed, your app will be associated with specified file types. When you open file with your app,
+new instance of app is launched and file path is passed as argument to your app.
+To handle this you should parse command line arguments in your app. Example:
+```go title="main.go"
+func main() {
+ argsWithoutProg := os.Args[1:]
+
+ if len(argsWithoutProg) != 0 {
+ println("launchArgs", argsWithoutProg)
+ }
+}
+```
+
+You also can enable single instance lock for your app. In this case, when you open file with your app, new instance of app is not launched
+and arguments are passed to already running instance. Check single instance lock guide for details. Example:
+```go title="main.go"
+func main() {
+ // Create application with options
+ err := wails.Run(&options.App{
+ Title: "wails-open-file",
+ Width: 1024,
+ Height: 768,
+ AssetServer: &assetserver.Options{
+ Assets: assets,
+ },
+ BackgroundColour: &options.RGBA{R: 27, G: 38, B: 54, A: 1},
+ SingleInstanceLock: &options.SingleInstanceLock{
+ UniqueId: "e3984e08-28dc-4e3d-b70a-45e961589cdc",
+ OnSecondInstanceLaunch: app.onSecondInstanceLaunch,
+ },
+ Bind: []interface{}{
+ app,
+ },
+ })
+}
+```
diff --git a/website/versioned_docs/version-v2.5.0/guides/frameless.mdx b/website/versioned_docs/version-v2.7.0/guides/frameless.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/guides/frameless.mdx
rename to website/versioned_docs/version-v2.7.0/guides/frameless.mdx
diff --git a/website/versioned_docs/version-v2.5.0/guides/frontend.mdx b/website/versioned_docs/version-v2.7.0/guides/frontend.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/guides/frontend.mdx
rename to website/versioned_docs/version-v2.7.0/guides/frontend.mdx
diff --git a/website/versioned_docs/version-v2.5.0/guides/ides.mdx b/website/versioned_docs/version-v2.7.0/guides/ides.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/guides/ides.mdx
rename to website/versioned_docs/version-v2.7.0/guides/ides.mdx
diff --git a/website/versioned_docs/version-v2.5.0/guides/linux-distro-support.mdx b/website/versioned_docs/version-v2.7.0/guides/linux-distro-support.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/guides/linux-distro-support.mdx
rename to website/versioned_docs/version-v2.7.0/guides/linux-distro-support.mdx
diff --git a/website/versioned_docs/version-v2.5.0/guides/linux.mdx b/website/versioned_docs/version-v2.7.0/guides/linux.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/guides/linux.mdx
rename to website/versioned_docs/version-v2.7.0/guides/linux.mdx
diff --git a/website/versioned_docs/version-v2.5.0/guides/local-development.mdx b/website/versioned_docs/version-v2.7.0/guides/local-development.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/guides/local-development.mdx
rename to website/versioned_docs/version-v2.7.0/guides/local-development.mdx
diff --git a/website/versioned_docs/version-v2.5.0/guides/mac-appstore.mdx b/website/versioned_docs/version-v2.7.0/guides/mac-appstore.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/guides/mac-appstore.mdx
rename to website/versioned_docs/version-v2.7.0/guides/mac-appstore.mdx
diff --git a/website/versioned_docs/version-v2.5.0/guides/manual-builds.mdx b/website/versioned_docs/version-v2.7.0/guides/manual-builds.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/guides/manual-builds.mdx
rename to website/versioned_docs/version-v2.7.0/guides/manual-builds.mdx
diff --git a/website/versioned_docs/version-v2.5.0/guides/migrating.mdx b/website/versioned_docs/version-v2.7.0/guides/migrating.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/guides/migrating.mdx
rename to website/versioned_docs/version-v2.7.0/guides/migrating.mdx
diff --git a/website/versioned_docs/version-v2.5.0/guides/mouse-buttons.mdx b/website/versioned_docs/version-v2.7.0/guides/mouse-buttons.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/guides/mouse-buttons.mdx
rename to website/versioned_docs/version-v2.7.0/guides/mouse-buttons.mdx
diff --git a/website/versioned_docs/version-v2.5.0/guides/obfuscated.mdx b/website/versioned_docs/version-v2.7.0/guides/obfuscated.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/guides/obfuscated.mdx
rename to website/versioned_docs/version-v2.7.0/guides/obfuscated.mdx
diff --git a/website/versioned_docs/version-v2.5.0/guides/overscroll.mdx b/website/versioned_docs/version-v2.7.0/guides/overscroll.mdx
similarity index 100%
rename from website/versioned_docs/version-v2.5.0/guides/overscroll.mdx
rename to website/versioned_docs/version-v2.7.0/guides/overscroll.mdx
diff --git a/website/versioned_docs/version-v2.7.0/guides/routing.mdx b/website/versioned_docs/version-v2.7.0/guides/routing.mdx
new file mode 100644
index 00000000000..ce176943ea5
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/guides/routing.mdx
@@ -0,0 +1,47 @@
+# Routing
+
+Routing is a popular way to switch views in an application. This page offers some guidance around how to do that.
+
+## Vue
+
+The recommended approach for routing in Vue is [Hash Mode](https://next.router.vuejs.org/guide/essentials/history-mode.html#hash-mode):
+
+```js
+import { createRouter, createWebHashHistory } from "vue-router";
+
+const router = createRouter({
+ history: createWebHashHistory(),
+ routes: [
+ //...
+ ],
+});
+```
+
+## Angular
+
+The recommended approach for routing in Angular is [HashLocationStrategy](https://codecraft.tv/courses/angular/routing/routing-strategies#_hashlocationstrategy):
+
+```ts
+RouterModule.forRoot(routes, { useHash: true });
+```
+
+## React
+
+The recommended approach for routing in React is [HashRouter](https://reactrouter.com/en/main/router-components/hash-router):
+
+```jsx
+import { HashRouter } from "react-router-dom";
+
+ReactDOM.render(
+
+ {/* The rest of your app goes here */}
+
+ } exact />
+ } />
+ } />
+ {/* more... */}
+
+ ,
+ root
+);
+```
diff --git a/website/versioned_docs/version-v2.5.0/guides/signing.mdx b/website/versioned_docs/version-v2.7.0/guides/signing.mdx
similarity index 94%
rename from website/versioned_docs/version-v2.5.0/guides/signing.mdx
rename to website/versioned_docs/version-v2.7.0/guides/signing.mdx
index b2a060c5f62..e57e99e76de 100644
--- a/website/versioned_docs/version-v2.5.0/guides/signing.mdx
+++ b/website/versioned_docs/version-v2.7.0/guides/signing.mdx
@@ -232,7 +232,7 @@ jobs:
path: build/bin/*
```
-For code signing on macOS, [gon](https://github.com/mitchellh/gon) is a very handy tool for code signing and communicating with Apple servers, also written in Go, and
+For code signing on macOS, [gon](https://github.com/Bearer/gon) is a very handy tool for code signing and communicating with Apple servers, also written in Go, and
will be used in this guide.
After the `Build Wails app` step, add the following to the workflow:
@@ -241,7 +241,7 @@ After the `Build Wails app` step, add the following to the workflow:
- name: MacOS download gon for code signing and app notarization
if: matrix.platform == 'macos-latest'
run: |
- brew install mitchellh/gon/gon
+ brew install Bearer/tap/gon
```
Now we need to configure some gon config files in our `build/darwin` directory:
@@ -254,19 +254,30 @@ Now we need to configure some gon config files in our `build/darwin` directory:
"bundle_id": "app.myapp",
"apple_id": {
"username": "my-appleid@email.com",
- "password": "@env:APPLE_PASSWORD"
+ "password": "@env:APPLE_PASSWORD",
+ "provider": "ABCDE12345"
},
"sign": {
- "application_identity": "Developer ID Application: My Name"
+ "application_identity": "Developer ID Application: Human User"
}
}
```
-Where `source` is your Wails binary, `bundle_id` is your bundle ID, `apple_id` contains your Apple ID username and App-Specific password
-which you created earlier, and `sign.application_identity` is your identity which you can find by running the following command:
+Here is a brief break down of the above fields:
+
+- `source`: The location of your wails binary to be signed
+- `apple_id`:
+ - `username`: Your Apple ID email address
+ - `password`: Your app-specific password, referenced using Gon's environment variable syntax
+ - `provider`: Your team ID for your App Store Connect account
+- `sign`:
+ - `application_identity`: Your Apple developer identity
+
+Your developer identity and team ID can both by found on macOS by running the following command:
```bash
-security find-identity -v -p codesigning
+$ security find-identity -v -p codesigning
+ 1) 00000000000000000000000000000000000000000 "Developer ID Application: Human User (ABCDE12345)"
```
2. entitlements.plist:
@@ -369,7 +380,7 @@ jobs:
- name: MacOS download gon for code signing and app notarization
if: matrix.platform == 'macos-latest'
run: |
- brew install mitchellh/gon/gon
+ brew install Bearer/tap/gon
- name: Import Code-Signing Certificates for macOS
if: matrix.platform == 'macos-latest'
uses: Apple-Actions/import-codesign-certs@v1
diff --git a/website/versioned_docs/version-v2.7.0/guides/single-instance-lock.mdx b/website/versioned_docs/version-v2.7.0/guides/single-instance-lock.mdx
new file mode 100644
index 00000000000..644e1e0d80c
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/guides/single-instance-lock.mdx
@@ -0,0 +1,80 @@
+# Single Instance Lock
+
+Single instance lock is a mechanism that allows you to prevent multiple instances of your app from running at the same time.
+It is useful for apps that are designed to open files from the command line or from the OS file explorer.
+
+## Important
+
+Single Instance Lock does not implement a secure communications protocol between instances. When using single instance lock,
+your app should treat any data passed to it from second instance callback as untrusted.
+You should verify that args that you receive are valid and don't contain any malicious data.
+
+## How it works
+
+Windows: Single instance lock is implemented using a named mutex. The mutex name is generated from the unique id that you provide. Data is passed to the first instance via a shared window using [SendMessage](https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-sendmessage)
+macOS: Single instance lock is implemented using a named mutex. The mutex name is generated from the unique id that you provide. Data is passed to the first instance via [NSDistributedNotificationCenter](https://developer.apple.com/documentation/foundation/nsdistributednotificationcenter)
+Linux: Single instance lock is implemented using [dbus](https://www.freedesktop.org/wiki/Software/dbus/). The dbus name is generated from the unique id that you provide. Data is passed to the first instance via [dbus](https://www.freedesktop.org/wiki/Software/dbus/)
+
+## Usage
+When creating your app, you can enable single instance lock by passing a `SingleInstanceLock` struct to the `App` struct.
+Use the `UniqueId` field to specify a unique id for your app.
+This id is used to generate the mutex name on Windows and macOS and the dbus name on Linux. Use a UUID to ensure that the id is unique.
+The `OnSecondInstanceLaunch` field is used to specify a callback that is called when a second instance of your app is launched.
+The callback receives a `SecondInstanceData` struct that contains the command line arguments passed to the second instance and the working directory of the second instance.
+
+Note that OnSecondInstanceLaunch don't trigger windows focus.
+You need to call `runtime.WindowUnminimise` and `runtime.Show` to bring your app to the front.
+Note that on linux systems window managers may prevent your app from being brought to the front to avoid stealing focus.
+
+```go title="main.go"
+var wailsContext *context.Context
+
+// NewApp creates a new App application struct
+func NewApp() *App {
+ return &App{}
+}
+
+// startup is called when the app starts. The context is saved
+// so we can call the runtime methods
+func (a *App) startup(ctx context.Context) {
+ wailsContext = &ctx
+}
+
+func (a *App) onSecondInstanceLaunch(secondInstanceData options.SecondInstanceData) {
+ secondInstanceArgs = secondInstanceData.Args
+
+ println("user opened second instance", strings.Join(secondInstanceData.Args, ","))
+ println("user opened second from", secondInstanceData.WorkingDirectory)
+ runtime.WindowUnminimise(*wailsContext)
+ runtime.Show(*wailsContext)
+ go runtime.EventsEmit(*wailsContext, "launchArgs", secondInstanceArgs)
+}
+
+func main() {
+ // Create an instance of the app structure
+ app := NewApp()
+
+ // Create application with options
+ err := wails.Run(&options.App{
+ Title: "wails-open-file",
+ Width: 1024,
+ Height: 768,
+ AssetServer: &assetserver.Options{
+ Assets: assets,
+ },
+ BackgroundColour: &options.RGBA{R: 27, G: 38, B: 54, A: 1},
+ OnStartup: app.startup,
+ SingleInstanceLock: &options.SingleInstanceLock{
+ UniqueId: "e3984e08-28dc-4e3d-b70a-45e961589cdc",
+ OnSecondInstanceLaunch: app.onSecondInstanceLaunch,
+ },
+ Bind: []interface{}{
+ app,
+ },
+ })
+
+ if err != nil {
+ println("Error:", err.Error())
+ }
+}
+```
diff --git a/website/versioned_docs/version-v2.7.0/guides/sveltekit.mdx b/website/versioned_docs/version-v2.7.0/guides/sveltekit.mdx
new file mode 100644
index 00000000000..e0357ca3c51
--- /dev/null
+++ b/website/versioned_docs/version-v2.7.0/guides/sveltekit.mdx
@@ -0,0 +1,136 @@
+# SvelteKit
+
+This guide will go into:
+1. Miminal Installation Steps - The steps needed to get a minimum Wails setup working for SvelteKit.
+2. Install Script - Bash script for accomplishing the Minimal Installation Steps with optional Wails branding.
+3. Important Notes - Issues that can be encountered when using SvelteKit + Wails and fixes.
+
+## 1. Minimal Installation Steps
+
+##### Install Wails for Svelte.
+- `wails init -n myapp -t svelte`
+
+##### Delete the svelte frontend.
+- Navigate into your newly created myapp folder.
+- Delete the folder named "frontend"
+
+##### While in the Wails project root. Use your favorite package manager and install SvelteKit as the new frontend. Follow the prompts.
+- `npm create svelte@latest frontend`
+
+##### Modify wails.json.
+- Add `"wailsjsdir": "./frontend/src/lib",` Do note that this is where your Go and runtime functions will appear.
+- Change your package manager frontend here if not using npm.
+
+##### Modify main.go.
+- The first comment `//go:embed all:frontend/dist` needs to be changed to `//go:embed all:frontend/build`
+
+##### Modify .gitignore
+- The line `frontend/dist` needs to be replaced with `frontend/build`
+
+##### Install/remove dependencies using your favorite package manager.
+- Navigate into your "frontend" folder.
+- `npm i`
+- `npm uninstall @sveltejs/adapter-auto`
+- `npm i -D @sveltejs/adapter-static`
+
+##### Change adapter in svelte.config.js
+- First line of file change `import adapter from '@sveltejs/adapter-auto';` to `import adapter from '@sveltejs/adapter-static';`
+
+##### Put SvelteKit into SPA mode with prerendering.
+- Create a file under myapp/frontend/src/routes/ named +layout.ts/+layout.js.
+- Add two lines into the newly created file `export const prerender = true` and `export const ssr = false`
+
+##### Test installation.
+- Navigate back into the Wails project root (one directory up).
+- run `wails dev`
+- If the application doesn't run please check through the previous steps.
+
+## 2. Install Script
+
+##### This Bash Script does the steps listed above. Make sure to read over the script and understand what the script is doing on your computer.
+
+- Create a file sveltekit-wails.sh
+- Copy the below code into the new file then save it.
+- Make it executable with `chmod +x sveltekit-wails.sh`
+- Brand is an optional param below that adds back in the wails branding. Leave third param blank to not insert the Wails branding.
+- Example usage: `./sveltekit-wails.sh pnpm newapp brand`
+
+##### sveltekit-wails.sh:
+```
+manager=$1
+project=$2
+brand=$3
+wails init -n $project -t svelte
+cd $project
+sed -i "s|npm|$manager|g" wails.json
+sed -i 's|"auto",|"auto",\n "wailsjsdir": "./frontend/src/lib",|' wails.json
+sed -i "s|all:frontend/dist|all:frontend/build|" main.go
+if [[ -n $brand ]]; then
+ mv frontend/src/App.svelte +page.svelte
+ sed -i "s|'./assets|'\$lib/assets|" +page.svelte
+ sed -i "s|'../wails|'\$lib/wails|" +page.svelte
+ mv frontend/src/assets .
+fi
+rm -r frontend
+$manager create svelte@latest frontend
+if [[ -n $brand ]]; then
+ mv +page.svelte frontend/src/routes/+page.svelte
+ mkdir frontend/src/lib
+ mv assets frontend/src/lib/
+fi
+cd frontend
+$manager i
+$manager uninstall @sveltejs/adapter-auto
+$manager i -D @sveltejs/adapter-static
+echo -e "export const prerender = true\nexport const ssr = false" > src/routes/+layout.ts
+sed -i "s|-auto';|-static';|" svelte.config.js
+cd ..
+wails dev
+```
+
+## 3. Important Notes
+
+##### Server files will cause build failures.
+- +layout.server.ts, +page.server.ts, +server.ts or any file with "server" in the name will fail to build as all routes are prerendered.
+
+##### The Wails runtime unloads with full page navigations!
+- Anything that causes full page navigations: `window.location.href = '//'` or Context menu reload when using wails dev. What this means is that you can end up losing the ability to call any runtime breaking the app. There are two ways to work around this.
+- Use `import { goto } from '$app/navigation'` then call `goto('//')` in your +page.svelte. This will prevent a full page navigation.
+- If full page navigation can't be prevented the Wails runtime can be added to all pages by adding the below into the `` of myapp/frontend/src/app.html
+```
+
+...
+
+
+
+...
+
+```
+See https://wails.io/docs/guides/frontend for more information.
+
+##### Inital data can be loaded and refreshed from +page.ts/+page.js to +page.svelte.
+- +page.ts/+page.js works well with load() https://kit.svelte.dev/docs/load#page-data
+- invalidateAll() in +page.svelte will call load() from +page.ts/+page.js https://kit.svelte.dev/docs/load#rerunning-load-functions-manual-invalidation.
+
+##### Error Handling
+- Expected errors using Throw error works in +page.ts/+page.js with a +error.svelte page. https://kit.svelte.dev/docs/errors#expected-errors
+- Unexpected errors will cause the application to become unusable. Only recovery option (known so far) from unexpected errors is to reload the app. To do this create a file myapp/frontend/src/hooks.client.ts then add the below code to the file.
+```
+import { WindowReloadApp } from '$lib/wailsjs/runtime/runtime'
+export async function handleError() {
+ WindowReloadApp()
+}
+```
+
+##### Using Forms and handling functions
+- The simplest way is to call a function from the form is the standard, bind:value your variables and prevent submission `![]({require("@site/static/img/showcase/encrypteasy.webp").default})
+ ![]({require("@site/static/img/showcase/filehound.webp").default})
+ ![]({require("@site/static/img/showcase/hiposter.webp").default})
+ ![]({require("@site/static/img/showcase/modalfilemanager.webp").default})
+ ![]({require("@site/static/img/showcase/mollywallet.webp").default})
+ ![]({require("@site/static/img/showcase/optimus.webp").default})
+ ![]({require("@site/static/img/showcase/portfall.webp").default})
+ ![]({require("@site/static/img/showcase/warmine1.png").default})
+ ![]({require("@site/static/img/showcase/warmine2.png").default})
+ ![]({require("@site/static/img/showcase/wombat.webp").default})
+ ![]({require("@site/static/img/defaultproject.webp").default})
+![]({require("@site/static/img/assetshandler-does-not-exist.webp").default})
+![]({require("@site/static/img/assetshandler-go-mod.webp").default})
+
+```
+
+Nous verrions ensuite ce qui suit:
+
+```mdx-code-block
+![]({require("@site/static/img/assetshandler-image.webp").default})
+![]({require("@site/static/img/vscode.webp").default})
+