Smooth CDN is a developer-friendly asset delivery platform designed to make managing and delivering production assets simple, predictable, and fast.

Instead of manually uploading files or exposing build directories, Smooth CDN introduces an explicit asset pipeline where assets are built locally, uploaded via CLI, and delivered through stable CDN URLs.

Smooth CDN is optimized for production assets such as scripts, styles, fonts, images, audio, video, documents, and static resources used by applications and websites.

Key principles

• Easy by default — push assets with a single CLI command.
• Optimized delivery — CDN caching and edge distribution built-in.
• Developer-first workflow — CLI-driven, CI/CD-friendly, and automation-ready.
• Optional asset versioning — for better managing assets for apps or widgets.
• Optional access control — restrict premium assets using tokens when needed.

Smooth CDN separates asset build from asset delivery, allowing teams to treat assets as part of their deployment pipeline instead of static public files.

This section defines the core concepts used throughout the Smooth CDN documentation.

Core concepts

• Developer panel — dashboard to manage projects, assets, versions, access tokens, and logs.
• Customer panel — dashboard to manage granted accesses as end user.
• Project — a logical unit representing a single application, plugin, widget, or product using Smooth CDN.
• Asset — a single file uploaded to Smooth CDN and delivered via the edge network.
• CLI — the primary tool used to initialize projects, upload assets, and manage deployments.
• Version (optional) — a project-level version used for controlled deployments and rollback.
• Access token (optional) — a token that grants access to protected assets.
• CDN — the global edge network responsible for caching and delivering assets.
• CI/CD — automated pipelines used to build and deploy assets programmatically.

This guide walks you through the basic Smooth CDN workflow: initializing a project, uploading assets, and using them in your application.

1. Application structure

In this example, we use a simple build output structure.

quick-start/
├─ dist/
│  ├─ app.js
│  ├─ app.css
│  └─ logo.png

Smooth CDN works with any framework or bundler. The only requirement is the final build output directory containing the files you want to deliver.

2. Login

Authenticate the CLI with your Smooth CDN account:

scdn login

3. Initialize a project

Initialize Smooth CDN project in your application root:

scdn init

This command initiates a wizard to create a .scdn.json configuration file and connects your local project with Smooth CDN.

4. Upload assets

Upload your build output to Smooth CDN:

scdn push

All files from your configured source directories are uploaded and instantly available via CDN, including supported media formats such as audio and video.

5. Use assets

Reference assets using stable CDN URLs:

<link rel="stylesheet" href="https://cdn.smoothcdn.com/username/quick-start/app.css" />
<script defer src="https://cdn.smoothcdn.com/username/quick-start/app.js"></script>

<img alt="Logo" src="https://cdn.smoothcdn.com/username/quick-start/logo.png" />

username is your user slug, available in the developer panel.

For projects with type versioned, URLs include version (for example:https://cdn.smoothcdn.com/username/quick-start/latest/logo.png). Forbasic projects, URLs do not contain a version segment.