Note covers
Add, reuse, position, and store cover images for notes on the web and desktop apps.
Each note can have a cover at the top of the editor. Choose a theme gradient, paste a public image URL, upload an image, or reuse one you have uploaded before.
Add or reuse a cover
Open a note's cover picker and choose one of the following:
- Gradient: applies a built-in theme gradient.
- Upload image: selects a PNG, JPEG, WebP, or GIF from your device.
- Your uploads: shows your previously uploaded cover images, newest first.
- Image URL: uses a public image URL directly.
Selecting an image from Your uploads does not create another copy of it. It reuses the existing stored image.
Gallery in Settings
Open Settings > Data and sync > Cover gallery to browse every cover image stored for your account. The gallery shows responsive thumbnails and opens an image at full size when selected. Use Refresh after uploading images in another tab or device.
The gallery is view-only. Deleting an asset could break the cover of an existing note, so Skriuw does not offer deletion from this screen.
Position and zoom an uploaded image
After an upload, the cover opens in edit mode. Drag the image in any direction to choose the visible area, then use the zoom controls to crop in more closely. Select Save to keep the position and zoom, or Cancel to keep the prior framing.
To adjust an existing image later, right-click its cover and choose Reposition. This is useful when the original image is larger than the cover banner.
Resize or hide a cover
Drag the thin handle at the bottom of an image cover upward to make the banner smaller, or downward to make it taller. Dragging it all the way up hides the cover. The chosen height is saved with the note and is restored on every device; select a cover again from the note metadata to show a hidden cover.
Web storage
On the web, uploaded covers are stored in the object store configured for your account:
- Your connected Vercel Blob or S3-compatible storage, when configured in Settings > Data and sync.
- Otherwise, the server's default S3-compatible storage or Vercel Blob store.
The gallery only lists files in your own covers/<user-id>/ storage prefix.
It never shows covers uploaded by other users. Uploads are limited to 2 MB per
file. Shared server storage has a 100 MB per-user limit; connected personal
storage is not subject to that shared limit.
Self-hosting setup is documented in Environment variables.
Supported providers
| Where configured | Provider | Notes |
|---|---|---|
| Your account, Settings > Data and sync | Vercel Blob | Connect with a Vercel Blob read/write token. Covers are public and the gallery can list them. |
| Your account, Settings > Data and sync | Any S3-compatible object store | Requires bucket, region, access key, secret key, and optionally a custom endpoint and public base URL. |
| Server environment | Default Vercel Blob | Set BLOB_READ_WRITE_TOKEN. This is used only when no default S3 storage is configured and the user has not connected personal storage. |
| Server environment | Default S3-compatible object store | Set the DEFAULT_STORAGE_S3_* variables. This takes precedence over the default Vercel Blob store. |
| Desktop app | Local filesystem | Covers are stored in the vault's cover-assets directory, described below. |
The S3-compatible option works with AWS S3 and providers that implement the S3 API, such as Cloudflare R2, MinIO, Backblaze B2 S3 API, and DigitalOcean Spaces. The bucket must allow public reads, because Skriuw stores and renders public image URLs.
Supabase Storage, Cloudinary, Google Cloud Storage, Azure Blob Storage, and Dropbox are not direct cover-storage providers today. They can only be used if you expose an S3-compatible API and public object URLs that satisfy the S3 configuration above.
Desktop storage
The desktop app stores uploaded covers on the local filesystem rather than in cloud object storage. By default they are written under:
<vault>/.skriuw/assets/cover-images/You can change the cover-assets directory in Desktop settings. Notes retain a
local vault-asset:<filename> reference and the desktop app reads the image
over Tauri IPC when it renders the cover.
The Your uploads picker and Settings gallery currently list web object storage. A local desktop gallery is not yet available; use an existing image file to upload it again on desktop.