Skip to content

Add steps to how setup Butterfly with Nextcloud in storage.md - #1002

Merged
CodeDoctorDE merged 21 commits into
LinwoodDev:developfrom
JerryMerweather:patch-10
Jul 28, 2026
Merged

Add steps to how setup Butterfly with Nextcloud in storage.md#1002
CodeDoctorDE merged 21 commits into
LinwoodDev:developfrom
JerryMerweather:patch-10

Conversation

@JerryMerweather

@JerryMerweather JerryMerweather commented Dec 8, 2025

Copy link
Copy Markdown
Contributor

I am still not finished, not sure what else to include.

Please call copilot because this is a draft with slight editing.

  • Steps 4 Nextcloud
  • Add pictures
  • Explain more about webDAV for non-nextcloud setups
  • explain what "directory" option does and how it works

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR enhances the storage documentation by adding detailed step-by-step instructions for setting up Butterfly with Nextcloud via WebDAV. The change transforms a single-line reference link into a comprehensive guide with two sections: one for obtaining the WebDAV URL and another for generating app-specific credentials in Nextcloud.

Key changes:

  • Added detailed instructions for obtaining the WebDAV URL from Nextcloud (5 steps)
  • Added instructions for creating and using app-specific passwords for secure authentication (8 steps)

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/src/content/docs/docs/v2/storage.md Outdated
Comment thread docs/src/content/docs/docs/v2/storage.md Outdated
Comment thread docs/src/content/docs/docs/v2/storage.md Outdated
Comment thread docs/src/content/docs/docs/v2/storage.md Outdated
JerryMerweather and others added 4 commits December 8, 2025 20:42
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@JerryMerweather

JerryMerweather commented Dec 8, 2025

Copy link
Copy Markdown
Contributor Author

That is amazing
As for images, I am having a hard time finding a markdown editor that could show me how my images will look.

I dont want to setup node.js

EDIT: I did anyway. also https://www.jotbird.com/ is good editor

will be deleted
i made the file to make this new dir, because github ide mode isnt working on firefox
@JerryMerweather

Copy link
Copy Markdown
Contributor Author

Yoo man, let that copilot do some checks.

@CodeDoctorDE

Copy link
Copy Markdown
Member

Copilot usage is so limited i can't do this anymore.
but here is chatgpt review:

Thanks for adding more detailed Nextcloud/WebDAV setup instructions. This is a useful improvement, but I think this should be cleaned up before merging.

A few things I noticed:

  • Please keep the existing explicit anchors: ## Remote storage {#remote} and ### Offline sync {#offline}. Removing them can break existing links to these sections.
  • The screenshots inside the numbered lists should probably be indented under their list items, otherwise the Markdown renderer may break/restart the ordered list.
  • The password/username section skips from step 5 to 7.
  • Name4.jpg seems to be added but unused, since the document references Name4.png.
  • The PR description still says this is unfinished. If this is still work-in-progress, it should probably be a draft PR; otherwise the checklist should be updated.

Also maybe rename the sections a bit more explicitly, for example:

#### Nextcloud: get the WebDAV URL
#### Nextcloud: create an app password

That would make it clearer that these exact steps are Nextcloud-specific, while the remote storage feature itself works with WebDAV in general.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 10 changed files in this pull request and generated 4 comments.

Comment thread docs/src/content/docs/docs/v2/storage.md Outdated
Comment thread docs/src/content/docs/docs/v2/storage.md Outdated
Comment thread docs/src/content/docs/docs/v2/storage.md Outdated
Comment thread docs/src/content/docs/docs/v2/storage.md
Comment thread docs/astro.config.mjs Outdated
@@ -7,6 +7,7 @@ import manifest from "./webmanifest.json";
import { fileURLToPath } from "node:url";
import { satteri } from '@astrojs/markdown-satteri';

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove this import, otherwise we import it twice

6. After authenticating, copy the username and paste it in the username input box in Butterfly
![](@assets/img/webDAV/Name3.png)
7. Finally, copy the password and paste it in the password input box in Butterfly
![](@assets/img/webDAV/Name4.png)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

add maybe a last part:

Suggested change
#### Finish the connection in Butterfly
1. Click `Connect`.
2. Enter a name for the connection.
3. Optionally specify a root directory.
4. Click `Create`.

@JerryMerweather JerryMerweather Jul 15, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, how did I forget this! THIS IS SUPER IMPORTANT and worth having a good description for it

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch 😉

@JerryMerweather

Copy link
Copy Markdown
Contributor Author

for the directory option,

  • Will it make a directory if the specified one doesnt exist?
  • Does this syntax work for folders with spaces (Documents/Linwood\ Butterfly)

@CodeDoctorDE

Copy link
Copy Markdown
Member
  1. You need to create it yourself (this is mainly for safety reasons so the app doesn't create accidently random folders you don't want to).
  2. This shouldn't work, just writing a space should work Documents/Linwood Butterfly

@JerryMerweather

JerryMerweather commented Jul 15, 2026 via email

Copy link
Copy Markdown
Contributor Author

Seriously doubting my skills as a programmer, how bad can it be?
Look... big is not my thing, I like it small. No dont take it the wrong way shut up.
@JerryMerweather

Copy link
Copy Markdown
Contributor Author

I think its complete like this:
preview of the new storage documentation

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 11 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (5)

docs/src/content/docs/docs/v2/storage.md:46

  • Heading capitalization is inconsistent with the product name used elsewhere (e.g., “Nextcloud” in the link above). Use “Nextcloud” consistently.
### Instructions for NextCloud

docs/src/content/docs/docs/v2/storage.md:83

  • “inputbox” should be “input box” (two words) for readability and consistency with other UI terminology in the doc.
Type the name of this connection in the `Name` inputbox, you can name it anything.

Then, for the `Directory` inputbox, you need to type where should Butterfly store stuff inside this cloud storage.

docs/src/content/docs/docs/v2/storage.md:90

  • Typo: “doesnt” → “doesn't”.
  - Butterfly will create the folder if it doesnt exist

docs/src/content/docs/docs/v2/storage.md:44

  • Under “To get the WebDAV URL…”, the Nextcloud link is no longer part of a list, which makes the formatting inconsistent with other locales and reads oddly after the colon. Add the list marker back.

This issue also appears in the following locations of the same file:

  • line 46
  • line 81
  • line 90
To get the WebDAV URL, please visit the documentation:

[Nextcloud](https://docs.nextcloud.com/server/latest/user_manual/en/files/access_webdav.html) (it should look like this: `https://nextcloud.example.com/remote.php/dav/files/username/`, replace `username` and `nextcloud.example.com` with the correct values)

docs/src/content/docs/docs/v2/storage.md:105

  • The “Offline sync” limitations section is missing the colon and omits the “top level only” limitation that still exists in other locale docs (e.g., docs/src/content/docs/hu/docs/v2/storage.md:51). If the limitation still applies, it should remain documented here as well, and the list marker should be consistent.
There are a few limitations
* You cannot delete a file or folder while you are offline.
* You cannot add, edit or delete templates while you are offline.

Comment thread docs/astro.config.mjs Outdated
JerryMerweather and others added 4 commits July 28, 2026 14:54
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@CodeDoctorDE
CodeDoctorDE merged commit fbd7121 into LinwoodDev:develop Jul 28, 2026
20 of 21 checks passed
@github-project-automation github-project-automation Bot moved this to ✅ Done in Butterfly Jul 28, 2026
@CodeDoctorDE

Copy link
Copy Markdown
Member

Thanks

@JerryMerweather
JerryMerweather deleted the patch-10 branch July 28, 2026 17:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

3 participants