Multiple Directories

Serve static files from multiple directories with different configurations per path.

Basic Usage

Configure multiple static directories:

import { Router } from '@neabyte/deserve'

const router = new Router()

// Admin panel static files
router.static('/admin', {
  path: './admin/dist',
  etag: true,
  cacheControl: 86400
})

// User uploads
router.static('/uploads', {
  path: './uploads',
  etag: false,
  cacheControl: 0
})

// API documentation
router.static('/docs', {
  path: './docs/build',
  etag: true,
  cacheControl: 3600
})

await router.serve(8000)

Common Patterns

Website + Admin Panel

// Main website
router.static('/', {
  path: './public',
  etag: true,
  cacheControl: 86400
})

// Admin panel
router.static('/admin', {
  path: './admin/dist',
  etag: true,
  cacheControl: 86400
})

Assets + Uploads

// Static assets with long-term caching
router.static('/assets', {
  path: './public/assets',
  etag: true,
  cacheControl: 31536000 // 1 year
})

// User uploads without caching
router.static('/uploads', {
  path: './uploads',
  etag: false,
  cacheControl: 0 // No cache
})

Development + Production

// Development files - short cache
router.static('/dev', {
  path: './dev',
  etag: true,
  cacheControl: 0 // No cache for dev
})

// Production build - long cache
router.static('/', {
  path: './dist',
  etag: true,
  cacheControl: 31536000 // 1 year
})

Directory Structure Examples

Full-Stack Application

.
├── main.ts
├── public/
│   ├── index.html
│   ├── css/
│   └── js/
├── admin/
│   └── dist/
│       ├── index.html
│       └── assets/
├── uploads/
│   ├── images/
│   └── documents/
└── docs/
    └── build/
        ├── index.html
        └── assets/

Microservices Frontend

.
├── main.ts
├── web/
│   └── dist/
├── api/
│   └── docs/
├── admin/
│   └── build/
└── mobile/
    └── public/

Configuration Examples

Different Caching Strategies

// Long-term cached assets (1 year)
router.static('/assets', {
  path: './public/assets',
  etag: true,
  cacheControl: 31536000
})

// Medium-term cache (1 day)
router.static('/images', {
  path: './public/images',
  etag: true,
  cacheControl: 86400
})

// No caching for dynamic uploads
router.static('/uploads', {
  path: './uploads',
  etag: false,
  cacheControl: 0
})

Different ETag Settings

// Enable ETag for efficient caching
router.static('/static', {
  path: './public',
  etag: true,
  cacheControl: 86400
})

// Disable ETag for frequently changing files
router.static('/reports', {
  path: './reports',
  etag: false,
  cacheControl: 3600
})

Troubleshooting

Route Conflicts

Routes are registered for all HTTP methods (GET, POST, etc.). Make sure static routes don't conflict with dynamic routes:

router.static('/', { path: './public' })
router.static('/admin', { path: './admin/dist' })

File Not Found

• Check path values are correct (relative to cwd or absolute)
• Verify directory structure matches configuration
• Ensure files exist in the specified directories
• Check URL paths match the route pattern

Performance Issues

• Enable etag: true for efficient caching
• Set appropriate cacheControl values based on content type
• Static assets: long cache (31536000 = 1 year)
• Dynamic content: short or no cache (0 or 3600)