mirror of
https://github.com/BookStackApp/BookStack.git
synced 2026-02-05 00:29:48 +03:00
Add web-app meta tags for fullscreen on mobile devices #1081
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @j0hannesr0th on GitHub (Mar 11, 2019).
Describe the feature you'd like
If you click "Add to Homescreen" on your Android or iOS device there is no icon available. Besides this if you open the newly created shortcut on your homescreen it opens the browser - but not fullscreen.
If you provide some meta tags the app opens in fullscreen mode in is like a native app.
Describe the benefits this feature would bring to BookStack users
Fullscreen and native app feeling on mobile devices of any os.
Additional context
ready to use repo: https://github.com/gokulkrishh/awesome-meta-and-manifest
@ssddanbrown commented on GitHub (Mar 13, 2019):
Thanks for the suggestion @hmr-it-jr.
There are two existing issues that seem to cover what you're requesting here:
In the interest of keeping duplicates reduced I'm going to close this. Please comment if I've misunderstood at all though.
@chillinPanda commented on GitHub (Mar 13, 2019):
Just a small addition to the above linked issue for PWA: It is #1253
@j0hannesr0th commented on GitHub (Mar 14, 2019):
@ssddanbrown are you sure you don't want to add this as feature to BookStack?
There is a generator which I use for other projects: https://tomitm.github.io/appmanifest/ - after using generator you just have to add the meta tags to /resources/views/public.blade.php and put the manifest.json in the public folder.
... that's it. Nothing more to do. I've done it to show you how it'd look like:
If I send a pull request would you merge it?
@ssddanbrown commented on GitHub (Mar 14, 2019):
@hmr-it-jr Just to be clear, I'm not rejecting this request, I've closed it as the requested feature set is already covered by other issues,
It's not quite that simple, We'll need to make the manifest accessible in the base template and make it dynamic to react to different configuration options. The icons may be tricky since the current app logo setting is likely not to be suitable for an app icon in many cases.
@j0hannesr0th commented on GitHub (Mar 14, 2019):
@ssddanbrown why not add the "simple" variant with static logo, etc. now that the users can benefit from the app like feeling and add the dynamic and configurable variant later?
@ssddanbrown commented on GitHub (Mar 15, 2019):
@hmr-it-jr We could do that but it will be another half-finished feature in the system.
It's always too easy to leave the hard pieces for later. I must admit though I'm somewhat haunted by the thoughts of the addition of a "simple" variant leading to a bunch of new issues requesting configurability and expansion on the feature.
@lignumaqua commented on GitHub (Aug 24, 2020):
This may be already known, but I didn’t find it in the documentation. You can add the meta tags for full-screen use on an iOS device in the 'Custom HTML Head Content' section within BookStack. The following works on an iPad when BookStack is run from a Home Screen bookmark
<meta name="apple-mobile-web-app-capable" content="yes">@igorrust commented on GitHub (Nov 20, 2022):
Nice find! Thanks!
When you open bookstack like this, it seems the way I think most imagine the site to act from the ios homescreen, but unfortunately when you select a book, it opens this book in a new "tab" (without addressbar though, but with back /share/done buttons). So it becomes only partial fullscreen.
Still hoping for a more permanent solution.