> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raycaster.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# File System Management

> Universal file and folder management concepts for organizing content in Raycaster AI

## Understanding the Raycaster File System

Raycaster provides a hierarchical file organization system, designed specifically for life sciences and biotech research teams. The file system supports multiple content types including sheets, pages, documents, and folders, all organized in an intuitive, structured way.

<Frame>
  <img src="https://mintcdn.com/raycaster/NkwkAu8IAZ9zTAYr/images/filesystem-overview.png?fit=max&auto=format&n=NkwkAu8IAZ9zTAYr&q=85&s=1d718da73aa22e79e93c5c81b22fce8f" alt="File System Overview" width="1421" height="637" data-path="images/filesystem-overview.png" />
</Frame>

## Content Types Overview

Raycaster supports several types of content that can be organized within the file system:

| Content Type                             | Purpose                                     | Key Features                                     |
| ---------------------------------------- | ------------------------------------------- | ------------------------------------------------ |
| [**Sheets**](/content-management/sheets) | Data tables with research capabilities      | AI research, data analysis, collaboration        |
| **Pages**                                | Flexible Notion-like content areas          | Rich formatting, embedded content, documentation |
| **Documents**                            | Google Docs-like collaborative text editing | Real-time collaboration, version history         |
| **Folders**                              | Hierarchical organization containers        | Content organization, permission inheritance     |

## Universal Creation Workflow

All content types in Raycaster follow a consistent creation pattern, making it easy to create any type of content from anywhere in your workspace.

<Steps>
  <Step title="Access Creation Options">
    Navigate to your workspace and choose one of these methods:

    * **Main Toolbar**: Click the "+" button or "Create" button at the top right
  </Step>

  <Step title="Select Content Type">
    Choose what you want to create:

    * **New Sheet**: For data tables and research workflows
    * **New Page**: For documentation and flexible content
    * **New Document**: For collaborative text editing
    * **New Folder**: For organizing other content
  </Step>

  <Step title="Configure Properties">
    Set up your content with universal properties:

    * **Title**: Enter a descriptive name
    * **Description (Optional)**: Add context and details
    * **Visibility**: Set access permissions (Private, Team, Public)
    * **Template**: Apply templates when available
  </Step>

  <Step title="Create Content">
    Click "Create" to add the content to your workspace and begin working
  </Step>
</Steps>

<Note>
  All content types inherit permissions from their parent folder by default, but you can customize permissions at the individual item level for fine-grained access control.
</Note>

## Sheets

Sheets provide powerful data tables with AI research capabilities, perfect for organizing and analyzing research data. With built-in research functions and collaboration features, sheets serve as the foundation for data-driven life sciences work.

<Card title="Comprehensive Sheets Guide" icon="table" href="/content-management/sheets">
  Complete documentation for creating, managing, and using sheets for research workflows, data analysis, and team collaboration.
</Card>

## Pages

Pages provide flexible content areas similar to Notion, designed for documentation, structured content, and organizing research information. Pages support rich formatting, embedded content, and real-time collaboration.

### Creating and Using Pages

Pages include a powerful Notion-like editor with drag-and-drop content blocks:

**Content Block Types:**

* **Text Content**: Headings (H1-H6), paragraphs, lists, quotes
* **Media and Structure**: Images, tables, code blocks, dividers
* **Interactive Elements**: Task lists, bookmarks, embedded content

**Key Features:**

* **Drag & Drop Organization**: Reorder content blocks by dragging
* **Auto-save Protection**: Content saves automatically every 3 seconds
* **Keyboard Shortcuts**: Type `/` to open block menu, use standard formatting
* **Real-time Collaboration**: Multiple users can edit simultaneously

<Frame caption="Page editor with drag-and-drop content blocks">
  <img src="https://mintcdn.com/raycaster/7UelhNhIiWBOCuCS/images/page.png?fit=max&auto=format&n=7UelhNhIiWBOCuCS&q=85&s=494a54d3e46134d575259925f24d6a2c" alt="Page editor showing content blocks and formatting options" width="1436" height="992" data-path="images/page.png" />
</Frame>

### Page Management

**Templates and Reusability:**

* **Pre-built Templates**: Research documentation, meeting notes, project plans
* **Custom Templates**: Create and share templates across your organization
* **Professional Formats**: Compliance-ready structures for life sciences teams

**Search and Discovery:**

* Full-text search across all accessible pages
* Recent activity tracking with user timestamps
* Bookmark system for quick access to important pages

**Export Options:**

* **PDF Export**: Professional document formatting
* **Markdown Export**: Portable text format
* **HTML Export**: Web-ready content

<Tip>
  Create page templates to standardize common structures like research protocols, project updates, and meeting notes across your organization.
</Tip>

## Documents

Documents provide professional-grade rich text editing with real-time collaboration, built specifically for life sciences teams. Using the advanced TipTap editor, documents combine familiar word processing with modern collaborative features.

### Rich Text Editor

**Text Formatting:**

* **Basic Formatting**: Bold, italic, underline, inline code
* **Document Structure**: Multiple heading levels, lists, blockquotes
* **Advanced Content**: Tables, task lists, images, code blocks

**Collaboration Features:**

* **Multi-user Editing**: Real-time collaborative editing with live cursors
* **AI Integration**: AI assistant can make real-time edits with oversight
* **Auto-save Protection**: Content saves automatically every 2 seconds

<Frame caption="Document editor with real-time collaboration">
  <img src="https://mintcdn.com/raycaster/NkwkAu8IAZ9zTAYr/images/document.png?fit=max&auto=format&n=NkwkAu8IAZ9zTAYr&q=85&s=9c638f152d00c1d482ae68bda96e81bc" alt="Document showing real-time collaboration and AI assistant" width="1409" height="978" data-path="images/document.png" />
</Frame>

### Import and Export

**Import Capabilities:**

* **Markdown (.md)**: Technical documentation, GitHub repos (100MB max)
* **Word Documents (.docx)**: Microsoft Word files with formatting preserved

**Export Options:**

* **Markdown (.md)**: Perfect for technical documentation and version control
* **Word Documents (.docx)**: Professional formatting for regulatory submissions

### Use Cases for Life Sciences

**Research Documentation:**

* Protocol development and standard operating procedures
* Literature reviews with structured findings
* Equipment usage guides and validation methods

**Regulatory and Compliance:**

* SOP documentation with version control
* Compliance reports for regulatory submissions
* Training materials and audit-ready documentation

## Folders

Folders provide hierarchical organization containers for all your content types. Think of folders as digital filing cabinets that help you structure your workspace logically, making it easy to find and manage related content.

### Folder Features

**Organization Benefits:**

* **Hierarchical Structure**: Create logical content hierarchies
* **Permission Inheritance**: Child content inherits folder permissions by default
* **Bulk Operations**: Move, organize, and manage multiple items
* **Access Control**: Set permissions at the folder level for streamlined management

**Best Practices:**

* Create logical hierarchies based on projects or teams
* Limit folder nesting depth to 4-5 levels maximum
* Use descriptive folder names that explain contents
* Regular reorganization to maintain clarity

<Frame>
  <img src="https://mintcdn.com/raycaster/NkwkAu8IAZ9zTAYr/images/folder.png?fit=max&auto=format&n=NkwkAu8IAZ9zTAYr&q=85&s=3c56e3ec2e578901e1f9ea9bf5410dcc" alt="Folder organization hierarchy" width="1438" height="989" data-path="images/folder.png" />
</Frame>

## Navigation and Discovery

### Quick Navigation

**Breadcrumb Navigation**: Clear path showing your current location with click-to-navigate functionality

**View Options:**

* **Grid View**: Visual thumbnails with quick preview
* **List View**: Detailed information in sortable columns

**Search and Filtering**: Full-text search across content with sorting by name, date, and type

## Content Organization

### Moving and Managing Content

<Steps>
  <Step title="Select Content">
    Click on the three dots at the right of any file to open the context menu
  </Step>

  <Step title="Choose Move Option">
    Click "Move to..." to open the destination selector
  </Step>

  <Step title="Select Destination">
    Choose destination folder from the hierarchical tree view
  </Step>

  <Step title="Confirm Move">
    Click "Move" to complete the operation
  </Step>
</Steps>

### Permission Management

**Access Control Levels:**

* **Private**: Only you can access the content
* **Team**: All organization members can access
* **Public**: Anyone with the link can access

### Deletion

<Warning>
  Permanent deletion that cannot be undone.
</Warning>

<Steps>
  <Step title="Select Content">
    Click the three dots on the content you want to delete
  </Step>

  <Step title="Choose Delete">
    Select "Delete" from the context menu
  </Step>

  <Step title="Confirm Deletion">
    Confirm the action in the dialog that appears
  </Step>
</Steps>

<div class="mt-8 bg-blue-50 dark:bg-blue-900/20 border-l-4 border-[#4F5DFF] p-4 rounded-r">
  <p class="text-gray-700 dark:text-gray-300">
    Ready to organize your workspace? Start by exploring our comprehensive <a href="/content-management/sheets" class="text-blue-600 dark:text-blue-400">Sheets guide</a> for data management and research workflows.
  </p>
</div>
