Document Management

Uxie provides a comprehensive document management system that makes it easy to organize your PDF library, collaborate with others, and keep track of your reading progress.

Uploading Documents

There are two ways to add PDFs to your Uxie library:

File Upload

Upload PDF files directly from your computer

URL Import

Import PDFs from URLs, Google Drive, or Dropbox

Upload from Computer

Open Upload Modal

Click the Upload File button on your library page

Select PDF

Drag and drop a PDF or click to browse your files

Optional: Enable OCR

Check “OCR PDF” to make scanned documents searchable

Upload

Click the Upload button to process your file

File Upload Requirements

File type: PDF only
Maximum size: 8MB
Page limit: Varies by plan (see AI features section)
Quantity: One file at a time

Upload from URL

Importing from URL is ideal for online documents or cloud storage:

Open the upload modal
Scroll to “Import from URL” section
Paste the PDF URL
Click Upload

Supported URL Sources:

Direct PDF links (ending in .pdf)
Google Drive share links
Dropbox public links
Any publicly accessible PDF URL

For Google Drive/Dropbox, ensure the link has public view permissions.

When importing from URL, only the URL is stored - not the file itself. The PDF loads from the original source each time you open it.

OCR Processing

OCR (Optical Character Recognition) converts scanned PDFs into searchable, selectable documents:

// OCR processing with Scribe.js
await scribe.importFiles(files);
await scribe.recognize({
  mode: "quality",
  langs: ["eng"],
  modeAdv: "combined",
  vanillaMode: true,
  combineMode: "data",
});

const data = await scribe.exportData("pdf");

OCR processing can take 30-60 seconds depending on the document size. The upload modal will show “Applying OCR, it might take a while…” during processing.

When to Use OCR

Scanned documents or images of text
PDFs that don’t allow text selection
Documents where search doesn’t work
Photos of book pages or handwritten notes

Your Document Library

The library page (/f) displays all your uploaded and shared documents.

Library Features

Search
Document Cards
Progress Tracking

Use the search bar to filter documents by filename. The search is instant and case-insensitive.

// Search filters documents by title
const filteredDocs = docs.filter((doc) =>
  doc.title.toLowerCase().includes(query.toLowerCase())
);

Document Card Information

Reading Progress

Visual ring showing % of document read

AI Status

Sparkle icon - filled if vectorized for AI features

Collaboration

“Collab” badge if shared with others

Cover Image

Thumbnail of first page

// Progress calculation
const showProgress = lastReadPage !== null && pageCount > 0;
const readingProgress = showProgress
  ? Math.round((lastReadPage / pageCount) * 100)
  : 0;

Opening Documents

Click any document card to open it in the full reader interface:

/f → Library page
/f/[docId] → Document viewer

The app automatically:

Loads your last read page
Restores your note-taking tab
Maintains your zoom and display settings
Syncs reading progress

Uxie remembers your last read page. When you return to a document, it automatically scrolls to where you left off.

Collaboration Features

Share documents with others and collaborate on notes in real-time.

Inviting Collaborators

Open Document

Navigate to the document you want to share

Click Invite Button

In the right sidebar, click the collaborate icon (visible only to document owners)

Enter Email Address

Type the email of the person you want to invite

Set Permissions

Choose view-only or edit permissions

Send Invitation

The collaborator receives an email invitation

Collaboration Permissions

Owner
Editor
Viewer

Full Control

Upload and delete documents
Invite collaborators
Edit notes
Change all settings
Manage permissions

Notes are collaborative by default when you share a document. All editors can see and edit the same notes in real-time using the BlockNote collaboration system.

Real-Time Collaboration

When multiple users have a document open:

Changes sync instantly across all sessions
Each user has a colored cursor
You can see who else is viewing/editing
Conflicts are automatically resolved

// Real-time collaboration powered by Liveblocks
import { LiveblocksProvider } from "@liveblocks/react";

// Each document has a unique room for collaboration
const room = useRoom();
const yDoc = new Y.Doc();
const yProvider = new LiveblocksProvider(room, yDoc);

Document Organization

Sorting and Filtering

While Uxie doesn’t currently have folders or tags, you can organize documents using:

Search - Quick filter by filename
Naming conventions - Use prefixes like “[Course]” or “[Project]”
Browser bookmarks - Bookmark specific documents

Use descriptive filenames before uploading:

CS101-Lecture-Notes-Week5.pdf
[Research] Machine Learning Survey 2024.pdf
Project_Proposal_Final_v2.pdf

Upload Limits by Plan

Free Plan
Paid Plans

Maximum documents: Varies by plan
Page limit for AI: Check your plan details
File size: 8MB per document
Collaboration: Basic features

// Upload limits enforced per plan
if (docsCount >= PLANS[userPlan].maxDocs) {
  toast.error("Upload limit exceeded", {
    description: `Upgrade to upload more than ${allowedDocsCount} documents.`,
  });
  return;
}

If you reach your document limit, you’ll need to upgrade your plan or delete existing documents to upload new ones.

Exporting Notes

Download your notes as Markdown files for use in other applications.

Export Markdown

Open Document

Navigate to any document with notes

Click Download Icon

In the right sidebar header, click the download button

Save File

Your notes are saved as notes.md

The exported Markdown includes:

All formatted text
Headings and structure
Lists and checkboxes
Code blocks
Links

// Export notes as markdown
const handleDownloadMarkdown = async () => {
  const markdownContent = await editor.blocksToMarkdownLossy(
    editor.document
  );
  const blob = new Blob([markdownContent], { type: "text/markdown" });
  saveAs(blob, "notes.md");
};

Exported Markdown files are compatible with:

Obsidian
Notion
VS Code
GitHub/GitLab
Any text editor

AI Vectorization

Documents under your plan’s page limit are automatically vectorized for AI features.

What is Vectorization?

Vectorization converts your PDF into a searchable AI database that enables:

Semantic search - Find content by meaning, not just keywords
Document chat - Ask questions about the entire document
Smart summaries - Context-aware summarization
Better AI completion - Notes AI has document context

Vectorization Status

Check if a document is vectorized:

Look for the sparkle icon (✨) on the document card
Filled sparkle = Vectorized
Gray sparkle = Not vectorized

Vectorization happens automatically in the background after upload. It may take a few minutes depending on document size.

Benefits of Vectorized Documents

Enhanced Chat

Chat feature can reference specific sections and pages

Better Flashcards

AI generates more relevant flashcard questions

Smarter Notes

AI completion understands document context

Semantic Search

Find content by meaning, not just keywords

Document Settings

Each document maintains individual settings:

Last read page - Auto-saved as you navigate
Zoom level - Persisted across sessions
Background color - White, cream, or custom
Reading mode preferences - TTS voice, speed, etc.

Settings are stored globally across devices when you’re logged in, so your preferences follow you everywhere.

Troubleshooting

Upload fails

Common causes:

File exceeds 8MB limit
File is not a valid PDF
Network connection issues
You’ve reached your plan’s document limit

Try compressing the PDF or splitting it into smaller files.

URL import doesn't work

Ensure:

URL points directly to a PDF file
The PDF is publicly accessible (not behind a login)
For Google Drive: Link sharing is set to “Anyone with the link”
The URL starts with https://

Document doesn't open

Check your internet connection (for URL imports)
Try refreshing the page
Check if you still have access (for shared documents)
Contact support if the issue persists

Reading progress not saving

Ensure you’re logged in
Progress saves automatically every 2 seconds
Check your browser’s local storage isn’t disabled
Try opening the document again

Collaborator can't see changes

Both users need to be online
Try refreshing the page
Check that edit permissions were granted
Ensure the document is shared with the correct email

OCR takes too long

OCR processing can take 1-2 minutes for large documents. This is normal. If it fails:

Try uploading without OCR first
Check file isn’t corrupted
Ensure stable internet connection

Best Practices

Document Organization Tips:

Use clear, descriptive filenames before uploading
Add prefixes or tags in square brackets: [Course] Topic.pdf
Keep related documents with similar naming patterns
Regularly export notes as backups
Use collaboration for group projects or study groups
Enable OCR for scanned documents immediately

Note-Taking

Learn about the collaborative note editor

Chat with PDF

Ask questions about your documents

Reading Modes

Explore different ways to read documents

Get Started

Core Features

Advanced Features

Configuration

​Uploading Documents

File Upload

URL Import

​Upload from Computer

​Upload from URL

​OCR Processing

​When to Use OCR

​Your Document Library

​Library Features

​Document Card Information

Reading Progress

AI Status

Collaboration

Cover Image

​Opening Documents

​Collaboration Features

​Inviting Collaborators

​Collaboration Permissions

​Real-Time Collaboration

​Document Organization

​Sorting and Filtering

​Upload Limits by Plan

​Exporting Notes

​Export Markdown

​AI Vectorization

​What is Vectorization?

​Vectorization Status

​Benefits of Vectorized Documents

Enhanced Chat

Better Flashcards

Smarter Notes

Semantic Search

​Document Settings

​Troubleshooting

​Best Practices

​Related Features

Note-Taking

Chat with PDF

Reading Modes

Build docs developers (and LLMs) love

Uploading Documents

Upload from Computer

Upload from URL

OCR Processing

When to Use OCR

Your Document Library

Library Features

Document Card Information

Opening Documents

Collaboration Features

Inviting Collaborators

Collaboration Permissions

Real-Time Collaboration

Document Organization

Sorting and Filtering

Upload Limits by Plan

Exporting Notes

Export Markdown

AI Vectorization

What is Vectorization?

Vectorization Status

Benefits of Vectorized Documents

Document Settings

Troubleshooting

Best Practices

Related Features