Content Delivery Network #
Duet serves all of its static assets through a Content Delivery Network for better performance and stability. CDN also makes it faster to implement and use our packages in production.
A content delivery network is a system of distributed servers that deliver pages and other static web content to users based on their geographic location, the origin of the webpage, and the content delivery server. Some of the benefits of using Duet’s CDN includes:
- Faster load times for all users.
- Better site performance and shared assets across different apps.
- Scales very rapidly during heavy traffic.
- Minimizes risk of traffic spikes at point of origin, ensuring stability.
- Decreases infrastructure costs due to traffic offloading.
- Faster to get up and running with development work, as teams don’t have to install the packages.
Available assets #
The following packages and all of their static assets (e.g. images, styles and scripts) are available for production usage via Duet CDN:
- Duet Web Components:
https://cdn.duetds.com/api/components/
- Duet CSS Framework:
https://cdn.duetds.com/api/css/
- Duet Design Tokens:
https://cdn.duetds.com/api/tokens/
- Duet Illustrations:
https://cdn.duetds.com/api/assets/illustrations/
- Duet Icons:
https://cdn.duetds.com/api/icons/
- Duet Fonts:
https://cdn.duetds.com/api/fonts/
URL structure #
Duet Content Delivery Network uses the following URL structure for the hosted Node.js packages:
https://cdn.duetds.com/api/<package>/<version>/<file>
To fetch e.g. the CSS Framework’s minified stylesheet using the above format, you would write it like:
https://cdn.duetds.com/api/css/4.0.45/lib/duet.min.css
Please note that Illustrations are the only exception to the above rule as they aren’t versioned. For illustrations, you need use the following URL structure:
https://cdn.duetds.com/api/assets/illustrations/<file>
- To find URLs for illustrations, see Illustrations documentation.
- To find URLs for icons, see Iconography documentation.
- To find URLs for Webfont imports, see Typography documentation.
- To find URLs for Web Components, see Components documentation.
- To find URLs for CSS Framework, see CSS Framework documentation.
- To find URL for Design Tokens as CSS Custom Properties, keep scrolling down.
Subresource Integrity #
Subresource Integrity is a security feature that enables browsers to verify that resources they fetch from a CDN are delivered without unexpected manipulation. It works by allowing you to provide a cryptographic hash that a fetched resource must match (source: MDN).
Our documentation provides cryptographic hashes for the latest available package versions, but you can also generate these hashes yourself for older versions using e.g. openssl command line tool. To enable SRI verification, use the following tags in the <head>
of your application:
Web Components:
<script type="module" src="https://cdn.duetds.com/api/components/8.7.1/lib/duet/duet.esm.js" integrity="sha384-c3hLghWHTPntUxndMlK4myD7d59stA2U0EvBp2rPb3ibtacAwh56geBpq6z7nXLn" crossorigin="anonymous"></script>
<script nomodule src="https://cdn.duetds.com/api/components/8.7.1/lib/duet/duet.js" integrity="sha384-H7RH4Ssj/LmElXa1VCHFSIjvtCSoLXMiPXG/KQZTS9EvYujTo7tWaj0V6/GGkY16" crossorigin="anonymous"></script>
CSS Framework:
<link rel="stylesheet" href="https://cdn.duetds.com/api/css/4.0.45/lib/duet.min.css" integrity="sha384-UoMJnpXiN8f7fKVnTzfKfyi7LzQlApQ+WTS9O3PXlYr6CO9yzou4glfsHV747f3v" crossorigin="anonymous" />
Design Tokens as CSS Custom Properties:
<link rel="stylesheet" href="https://cdn.duetds.com/api/tokens/4.0.59/lib/tokens.custom-properties.css" integrity="sha384-AexjbYNj18dJLZR54wNVU44b/akdDc+tpbLIWhAnzjMAbwFSli2DHpSP+7NCK+Xw" crossorigin="anonymous" />
Fonts for LocalTapiola:
<link rel="stylesheet" href="https://cdn.duetds.com/api/fonts/3.0.51/lib/localtapiola.css" integrity="sha384-5JYmtSD7nykpUvSmTW1CHMoBDkBZUpUmG0vuh+NUVtZag3F75Kr7+/JU3J7JV6Wq" crossorigin="anonymous" />
Fonts for Turva:
<link rel="stylesheet" href="https://cdn.duetds.com/api/fonts/3.0.51/lib/turva.css" integrity="sha384-hHdwZODJ+y2QoCpmMYq9dSnwexFN8FO9B9cVru7Y7iy2l3bXKpf/vNfPASXgfKWU" crossorigin="anonymous" />
Available versions #
Duet Content Delivery Network includes versioned releases of the following Node.js packages starting from version number:
- @duetds/components:
4.2.9
and newer - @duetds/css:
1.4.6
and newer - @duetds/tokens:
2.0.30
and newer - @duetds/fonts:
1.3.12
and newer - @duetds/icons:
2.0.27
and newer
Troubleshooting #
If you experience any issues while getting set up with Duet Content Delivery Network, please head over to the Support page for more guidelines and help.