<![CDATA[Cloudron First Use Instructions Modal]]>I must explain the same things many times to new users logging in to my.example.com.

It would be a big time-saver, for them and me, if we could have a first-use pop-up modal that contained one page with first-use welcome introductions and explanations.

This could be dismissed, and a (?) icon put in the top-bar for clicking to see it again.

Admins should be able to edit it.

I do something similar with the Rocket Chat Home page - but then I have to get people through the my.example.com login first, so it makes more sense to have the instructions there to get them into all the other apps necessary for their work and communications.

]]>https://forum.cloudron.io/topic/5084/cloudron-first-use-instructions-modalRSS for NodeFri, 10 Apr 2026 20:25:28 GMTTue, 18 May 2021 11:06:26 GMT60<![CDATA[Reply to Cloudron First Use Instructions Modal on Wed, 19 May 2021 16:18:39 GMT]]>@marcusquinn yes, I think for a start if it's just a simple popup with some customizable markdown, I think it's easy to add this.

]]>https://forum.cloudron.io/post/31559https://forum.cloudron.io/post/31559Wed, 19 May 2021 16:18:39 GMT<![CDATA[Reply to Cloudron First Use Instructions Modal on Wed, 19 May 2021 01:11:17 GMT]]>Cool - OK, we have interest - I'll do some draft copywriting for this to give you an idea what's currently working for me.

]]>https://forum.cloudron.io/post/31534https://forum.cloudron.io/post/31534Wed, 19 May 2021 01:11:17 GMT<![CDATA[Reply to Cloudron First Use Instructions Modal on Tue, 18 May 2021 22:13:51 GMT]]>@girish Correct. It would be for onboarding users that access the dashboard my.domain.tld

]]>https://forum.cloudron.io/post/31529https://forum.cloudron.io/post/31529Tue, 18 May 2021 22:13:51 GMT<![CDATA[Reply to Cloudron First Use Instructions Modal on Tue, 18 May 2021 20:56:52 GMT]]>If someone can provide a nice one page modal example, it will be easy to copy / reimplement.

p.s. it should have dark mode CSS capability..

]]>https://forum.cloudron.io/post/31524https://forum.cloudron.io/post/31524Tue, 18 May 2021 20:56:52 GMT<![CDATA[Reply to Cloudron First Use Instructions Modal on Tue, 18 May 2021 20:46:55 GMT]]>@atrilahiji Just clarifying for myself. The pop up instructions are for your users (i.e the local Cloudron users) correct ? As opposed to some sort of onboaring/welcome flow on how to use Cloudron.

]]>https://forum.cloudron.io/post/31521https://forum.cloudron.io/post/31521Tue, 18 May 2021 20:46:55 GMT<![CDATA[Reply to Cloudron First Use Instructions Modal on Tue, 18 May 2021 19:22:23 GMT]]>@jdaviescoates true. I guess it could be a WYSWYG editor with an HTML option?

]]>https://forum.cloudron.io/post/31511https://forum.cloudron.io/post/31511Tue, 18 May 2021 19:22:23 GMT<![CDATA[Reply to Cloudron First Use Instructions Modal on Tue, 18 May 2021 19:11:17 GMT]]>@atrilahiji sure, fair point. I guess I just like the idea of being able to simply write some text somewhere rather than having to do any coding of any type (including html).

But I guess it would also be pretty cool for admins who want to go all out with multiple JS slides or whatever to be able to do so too.

]]>https://forum.cloudron.io/post/31509https://forum.cloudron.io/post/31509Tue, 18 May 2021 19:11:17 GMT<![CDATA[Reply to Cloudron First Use Instructions Modal on Tue, 18 May 2021 19:06:23 GMT]]>@jdaviescoates I mean with the generic approach of using a "slides" sort of method covers this by just having a single slide. I think having this flexibility will limit the number of requests @staff get and shift the responsibility to server owners.

]]>https://forum.cloudron.io/post/31508https://forum.cloudron.io/post/31508Tue, 18 May 2021 19:06:23 GMT<![CDATA[Reply to Cloudron First Use Instructions Modal on Tue, 18 May 2021 19:07:12 GMT]]>I think I'd actually prefer a simple one page pop-up instructions thing like @marcusquinn is proposing rather than the Nextcloud approach (I'm always ever so mildly annoyed but such things), but I can see the value in both approaches.

]]>https://forum.cloudron.io/post/31507https://forum.cloudron.io/post/31507Tue, 18 May 2021 19:07:12 GMT<![CDATA[Reply to Cloudron First Use Instructions Modal on Tue, 18 May 2021 19:03:50 GMT]]>@robi Exactly what I was imagining. Yeah this would be nice and fairly straight forward to do (I would think).

More than the technical side of things, the main challenge would be sorting out the "perfect" language to use in this modal to properly onboard people.

One way to avoid having the onus on @staff would be to disable it by default and when enabled, it lets the admin create their own "slides" with html markup to show to new users. This way @girish and @nebulon can avoid the nightmare of constantly fielding requests to adjust parts of the text when people just do it themselves. Considering all that they do this seems like the most sustainable solution.

]]>https://forum.cloudron.io/post/31504https://forum.cloudron.io/post/31504Tue, 18 May 2021 19:03:50 GMT<![CDATA[Reply to Cloudron First Use Instructions Modal on Tue, 18 May 2021 17:02:32 GMT]]>See what nextcloud does with a new account?

Points out a few things to click through to get an orientation.

It's just some .js overlay bubbles.

]]>https://forum.cloudron.io/post/31493https://forum.cloudron.io/post/31493Tue, 18 May 2021 17:02:32 GMT<![CDATA[Reply to Cloudron First Use Instructions Modal on Tue, 18 May 2021 16:32:01 GMT]]>Are you thinking of a customizable popup or adding a popup? Any ideas on what this popup might contain?

Possibly related, would it help if the welcome/invite mail had better instructions. There is a plan to make that mail customizable at some point and that of course can have links to some external site for instructions.

]]>https://forum.cloudron.io/post/31491https://forum.cloudron.io/post/31491Tue, 18 May 2021 16:32:01 GMT