Palmr.

Deprecated version documentation

This documentation refers to a previous version of Palmr. It may contain more complex configurations and bugs that have already been fixed.

View latest documentation (v3.0-beta)

Creating a share

To create a share in Palmr, the process is very intuitive and self-explanatory. There are multiple ways to create a share, but the most straightforward method is through the Home Page, specifically in the Recent Shares section.

Home Page

On the home page, there is a "Recent Shares" section. When no shares have been created yet, this section will appear as follows:

Recent Shares Section

Since no shares exist yet, you will see a "Create Share" button prominently displayed.

Create Share Button

Note: You don’t need to upload files to create a share! Yes, it’s entirely possible to create a share without adding any files. While this might not make sense in every scenario, some users and use cases find this feature highly valuable.

As mentioned above, shares in Palmr are created first with their settings, and then files can be added later. You can also edit a share at any time.

To create a share, simply click the "Create Share" button in the center of the Recent Shares section. Doing so will open the following Create Share modal:

Create Share Modal

Fill in the required information in the modal. The fields Expiration Date, Max Views, and Password are optional but significantly impact how the share functions for recipients:

  • Password: If set, the recipient must enter the correct password to access the share.
  • Max Views: If the limit is reached, the share will no longer be accessible unless the creator increases or removes the limit.
  • Expiration Date: After the expiration date, the share will automatically be disabled unless extended by the creator.

Even the name field is optional, but we recommend setting a name for better organization.

Once a share is created, the Recent Shares section updates to display a table with the following fields:

  • Name
  • Created At
  • Expires At
  • Status
  • Security
  • Files
  • Recipients
  • Actions

Shares Table

To create additional shares, a "New Share" button appears in the upper right corner of the Recent Shares section.

New Share Button

Clicking this button will reopen the Create Share modal.

The Recent Shares section displays only the last 5 shares. To view all created shares, click the "View All" button.

Shares Filled

View All Button

Clicking this redirects you to the Shares Management page.

Shares Management Page

Another way to access the Shares Management page is by clicking the "My Shares" card on the home page.

My Shares Card


Shares Management Page

The Shares Management page is similar to the Uploads Management page, but here, you can add, remove, edit, and view all created shares without the limitation of only displaying the last 5 shares.

Each share has an Actions column with the following options:

Actions Column

Edit Share

Clicking the Edit button allows you to modify the share details.

Edit Share Modal

Manage Files

Clicking the Manage Files button lets you add or remove files from the share.

Manage Files Modal

Manage Recipients

Clicking the Manage Recipients button lets you add or remove recipients for the share.

Note: Email notifications will only be sent if SMTP settings are properly configured in the system.

Manage Recipients Modal

View Share Details

Clicking View Details lets you see all details of a share.

View Details Modal

Clicking the Generate Link button creates a shareable link, which can be customized.

Generate Link Modal

Once generated, you can view and copy the link.

Copy Link Modal

The generated link can be edited or copied from a dropdown menu.

Edit or Copy Link Dropdown

When the generated link is accessed, the recipient can view and download the shared files.

Shared Page Preview

Delete Share

Clicking the Delete button allows you to permanently remove a share. Delete Share Modal


Summary

Palmr’s share creation process is intuitive and flexible. You can create a share without files, edit share settings, manage recipients, and generate shareable links. The Shares Management page provides a full overview of all shares, ensuring you have complete control over your file-sharing process.

On this page