Folders & Organization

Claspt gives you multiple ways to organize your pages: folders for structure, pins for quick access, archives for hiding old content, and flexible sorting to surface what matters most.

Default Folders

Every new vault is created with two starter folders:

Folder	Purpose
general/	Default home for new pages when no other folder is selected
credentials/	Suggested location for pages containing passwords, API keys, and other secrets

These are regular filesystem directories — you can rename, delete, or reorganize them at any time. If you delete all folders, Claspt recreates general/ so there’s always somewhere to put new pages.

Creating Folders

There are two ways to create a folder:

1. Sidebar button — Click the folder icon (+ with folder) in the sidebar header. Type a name and press Enter.
2. Context menu — Right-click in the sidebar folder tree and select New Folder.

Nested Folders

Create nested folders by using a / separator in the folder name:

work/projects/acme

This creates the full hierarchy: work/ > projects/ > acme/. The sidebar displays nested folders as a collapsible tree.

Tip

Plan your top-level folders around broad categories (e.g., work/, personal/, credentials/), then nest as needed. Flat structures are easier to navigate, so don’t nest deeper than two or three levels unless you really need to.

Moving Pages

Drag and Drop

Drag a page from the page list and drop it onto a folder in the sidebar tree. The page’s file moves on disk and its frontmatter updates automatically.

Context Menu

Right-click a page in the sidebar and select Move to…, then pick the destination folder from the list.

Bulk Move

Select multiple pages (hold Cmd / Ctrl and click), then right-click and choose Move to…. All selected pages move to the chosen folder.

Renaming Folders

Right-click a folder in the sidebar and select Rename. Type the new name and press Enter. All pages inside the folder are moved automatically — their frontmatter folder field updates to reflect the new name.

Note

Renaming a folder renames the actual directory on your filesystem. Since pages reference their folder in YAML frontmatter, Claspt updates every affected page’s metadata in one step.

Deleting Folders

Right-click a folder and select Delete. You’ll be prompted with two options:

Option	What Happens
Move contents to parent	Pages move up one level (or to the vault root). The folder is removed.
Delete all pages	The folder and all its pages are permanently deleted.

Caution

Deleting pages is permanent — they are removed from disk. If you have Git history enabled, you can recover them from a previous commit, but it’s safer to archive pages you might need later.

Folder Tree in the Sidebar

The sidebar displays your folders as a collapsible tree:

• Click a folder to filter the page list to only pages in that folder.
• Expand/collapse nested folders by clicking the arrow next to the folder name.
• Page counts appear next to each folder, showing how many pages it contains.
• Click “All Pages” at the top of the folder tree to remove the folder filter and see every page in your vault.

Page Naming Convention

On disk, pages follow this naming pattern:

YYYY-MM-DD-HHMMSS-title-slug.md

For example, a page titled “AWS Credentials” created on January 15, 2025 at 2:30 PM becomes:

2025-01-15-143000-aws-credentials.md

This ensures pages are unique and sort chronologically in file explorers. The human-readable title is stored in the YAML frontmatter, not the filename.

Tip

You never need to worry about filenames — Claspt generates them automatically. The title you see in the app comes from the frontmatter title field, not the filename.

Pinning Pages

Pin frequently used pages so they always appear at the top of the page list, regardless of sort order.

• To pin: Right-click a page and select Pin to Top, or click the pin icon in the toolbar when viewing a page.
• To unpin: Right-click a pinned page and select Unpin, or click the pin icon again.

Pinned pages show a pin indicator in the sidebar. Multiple pinned pages sort among themselves by the active sort order.

Archiving Pages

Archive pages you want to keep but don’t need to see day-to-day. Archived pages are hidden from the sidebar by default.

• To archive: Right-click a page and select Archive, or use the archive button in the toolbar.
• To unarchive: Toggle archive visibility (see below), then right-click the archived page and select Unarchive.

Viewing Archived Pages

Toggle archived page visibility from the sidebar filter controls. When visible, archived pages appear with a dimmed style so you can distinguish them from active pages.

Note

Archiving does not delete or move the file — it simply sets archived: true in the page’s YAML frontmatter. The page remains fully searchable.

Sort Options

Control how pages are ordered in the sidebar:

Sort By	Description
Title	Alphabetical by page title (A-Z or Z-A)
Date Created	By creation timestamp (newest or oldest first)
Date Updated	By last modification timestamp (newest or oldest first)

Click the sort button in the sidebar to cycle through options. Each sort field can be ascending or descending.

Sidebar Density

Switch between two density modes for the page list:

Mode	Description
Comfortable	More spacing, shows page preview snippet beneath the title
Compact	Tighter spacing, title only — fits more pages on screen

Toggle density from the sidebar controls (the density icon near the sort options).

Page Frontmatter

Every page is a standard markdown file with YAML frontmatter. Here’s what a typical page looks like on disk:

---
id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
title: AWS Credentials
folder: credentials
created_at: 2025-01-15T14:30:00Z
updated_at: 2025-01-15T16:45:00Z
pinned: true
archived: false
tags:
  - aws
  - devops
---

Your markdown content here...

All organization metadata (folder, pinned, archived, tags) lives in the frontmatter, keeping everything portable and version-controlled.

Best Practices

• Use folders for physical grouping — credentials in one place, project notes in another, personal items separate.
• Pin your active pages — Keep the 3-5 pages you use daily pinned to the top.
• Archive instead of deleting — If you might need a page later, archive it rather than deleting.
• Combine with tags — Folders give structure; tags give flexibility. A page in work/projects/ can also be tagged urgent and client-a for cross-cutting organization.
• Keep it shallow — Two levels of nesting (work/projects/) is usually enough. Deeply nested folders are harder to navigate.

Tip

Combine pinning with sorting for an efficient workflow: pin your active projects to the top, then sort remaining pages by “Date Updated” (newest first) so recent work is always visible.