---
description: 'Curated pluggable content'
sidebar_position: 1
---

# Content Packs

You can create your own content pack! It simply needs to be set up as a
**static website with local links**. This website will run from the box
itself, so all of the images and files required for the website need to be
contained within one main folder.

Once you have your static website ready, you will put all of the required
files for it in one folder, and place this folder in the **root directory**
of your USB drive. This website will be rendered in the browser people use
to access the Butter Box portal.

Tips for creating a content pack with a static website:

* **Contents.** Everything for the static website must be stored on a USB
  drive that plugs into the Butter Box. It should not link to resources on
  the global internet.
* **Size.** The size of your content pack is limited by the amount of space
  available on your USB drive. Though, keep in mind that if multiple people
  are downloading or watching really large files from the box, there may be
  some latency.
* **Pages.** Links between pages should point to other saved pages in the
  same folder, not to the internet. You must use relative paths
  (e.g. about/index.html) instead of absolute web URLs.
* **Media.** Pictures, videos, and sounds cannot be linked to from somewhere
  online. The files need to be in your website folder and stored on the USB
  drive.
* **Libraries.** The website cannot use javascript libraries that rely on an
  internet connection.
* **Styles.** Special fonts and icons (like those from Google Fonts) also
  need to be packed into the folder, not fetched from the web.

### Try It

* The zip file below contains a sample static website. To get a feel for how
  static websites work with butter—Download it. Unzip it. Then, add this set
  of files to your USB drive.

[Sample Static Website.zip](/img/docs/Sample%20Static%20Website.zip)

You can also check out our [New Content Pack News](/docs/content-packs).

### Empezar

The best way to get started with creating your own content pack is to have
an idea about the experience and type of information you want to provide,
and then to design and build a local static website for it.

It can be very simple like an audio player for music. Or, a simple list of
the five top VPN apps that you recommend. Or it can be more complex like a
library or knowledge base of cultural artifacts.



### Add website files to a USB drive

Place a folder with your website files in the **root directory** of a USB
drive. Be sure that your website folder contains your **index.html.** The
name of this folder will be displayed on the Butter Box portal.

<figure><img src="/img/docs/Screenshot 2025-08-16 at 9.46.16 PM.png" alt=""/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>

### Connect to your Butter Box to view

Insert the USB drive into your Butter Box. When you open the Butter Box
portal, tap **Files**. Navigate to the website folder. Tap to view.

