elibroftw / modern-desktop-app-template

Tauri & ReactJS boilerplate for a modern desktop application. Not a project nor a substitute for my Tauri video tutorials.

Modern Desktop App Template

Tauri and React boilerplate for a modern desktop application. Not a project nor a substitute tutorial for my video tutorials. I didn't use yew (wasm) since its component libraries are not to the calibre of existing React component libraries.

Template Instructions

1. Have git installed
2. Download this repository and rename the folder to YOUR_APP or click "use this template" and clone your new repo that is referred to henceforth as YOUR_APP
3. Open YOUR_APP in an IDE
4. Follow environment instructions in SAMPLE_README.md
5. While you run yarn to install dependencies,
   • Modify productName, identifier, title found in src-tauri/tauri.conf.json
   • Modify authors in src-tauri/Cargo.toml
   • Modify HEADER_TITLE, FOOTER found in src/utils.js
   • If you didn't click "use this template", remove the .git folder and reinitialize your own git repo
   • Delete or replace LICENSE.md since this template is public domain
   • Edit SAMPLE_README.md and replace README.md
6. Run yarn dev to start developing
7. Read Tips and Trouble Shooting section of the new README.md
8. If any problems arise, open an issue or contact me

Ground-up Instructions

RSS of Commit History

Add https://github.com/elibroftw/modern-desktop-app-template/commits.atom to your RSS reader to stay up to date! I do not recommend pulling from my repo because you will need to edit the same files I reorganize

Tips

Screenshots

• The four views not found in boilerplate were added by yours truly. My About is the ViewExample provided in src
• Home view is purposely not translated since it's a filler

Future Resources

URL Schema (used with Single Instance)

The single instance plugin is already included in this template. Combine this plugin with the reading from below to get a Windows app URL protocol. This can be used for say Music Players, PDF Readers, etc.

• URL schema

modern-desktop-app-template's Issues

Fail to prompt to save / quit before closing window due to defect of `appWindow.close`

"onCloseRequested" can be caught if clicking "Close window" in taskbar, but it is bypassed if clicking customized "close" button in right-top of window

const unlisten = await appWindow.onCloseRequested(async (event) => {
    const confirmed = await confirm('Are you sure?');
    if (!confirmed) {
      event.preventDefault();
    } else {
      unlisten();
    }
  });

It is limitation of Tauri, Could you replace appWindow.close with other function? (I try to replace it with process.exit(), but it also cannot trigger 'tauri://close-requested' event :()

Refer to: tauri-apps/tauri#5288 (comment)
Refer another: tauri-apps/plugins-workspace#254

How to build as a standalone app

Currently I can only access the application in a browser, is there support for packaging the application as a standalone executable file?

> yarn dev
yarn run v1.22.19
$ yarn nvmrc
$ node -v > .nvmrc
$ tauri dev
     Running BeforeDevCommand (`yarn start`)
$ vite
  VITE v4.3.9  ready in 719 ms
  ➜  Local:   http://localhost:1420/

Thanks

Fallback path error

On App.jsx, imported wrongly the file Fallback, imported on Views/Fallback, but exists on src/Fallback

Ubuntu Build - Not executing

I am getting the builds:

kiosk_0.0.0_amd64.AppImage
kiosk_0.0.0_amd64.deb
kiosk_0.0.0_x64-setup.exe
kiosk_0.0.0_x64.dmg
kiosk_0.0.0_x64_en-US.msi
kiosk_x64.app.tar.gz

I am using linux Ubuntu, when I try to run kiosk_0.0.0_amd64.AppImage it says, there is no application installed for "AppImage application bundle” and when I right clicked set allow executing file as program nothing happens.

I need a armv8 build, is there something on top of mind that I am missing? I have been struggling with this for a while (tauri linux build for client use).

Uncaught TypeError: appWindow.title is not a function

Hello, there is an error: