Back to Features

Entity-First Files & Folders

In Vadyl, files and folders are not an afterthought—they're first-class entities that integrate seamlessly with your data model. Link files directly to any entity record without configuring separate storage buckets or managing S3 keys. Files inherit the same permissions, relationships, and querying capabilities as your other entities. Upload a user's profile photo, attach invoices to orders, or organize project documents—all through the same unified interface.

<5ms
CDN Latency
5GB
Max File Size
0min
Setup Time
example.ts
// Link files directly to entities
const invoice = await Invoice.create({
  customer: customerRef,
  total: 1250.00,
  // Files are just entity references
  pdf: await vadyl.files.upload("invoice.pdf"),
  attachments: await vadyl.folders.create("receipts")
});

// Query files like any other entity
const allPDFs = await vadyl.files.find({
  type: "application/pdf",
  "linkedTo.entity": "Invoice"
});

Key Benefits

Unified Model

Files are entities—query, filter, and relate them like any other data.

Auto-CDN

Global CDN distribution with <5ms edge delivery for all files.

Zero Config

No S3 buckets, no storage providers—just define and use.

Real-World Use Cases

Document Management

Build file systems with nested folders linked to projects or users.

Media Attachments

Attach images, PDFs, and videos directly to entity records.

Ready to try Entity-First Files & Folders?

Start building with Vadyl today and experience the difference.