# Fell — a Gitea theme

A Gitea theme inspired by [dideric.is](https://dideric.is). Parchment body, near-black nav, teal accent, and [IM Fell Type](https://iginomarini.com/fell/) throughout.

![Fell theme screenshot](https://gitea.dideric.is/didericis/gitea-fell-theme/raw/branch/main/preview.png)

## What's in the box

```
public/
  assets/
    css/
      theme-fell.css      ← the theme (all 244 Gitea CSS variables)
    fonts/
      IMFePIrm29P.ttf     ← Fell Type regular
      IMFePIit29P.ttf     ← Fell Type italic
      IMFeDPsc29P.ttf     ← Fell Type small caps (headings/nav)
```

The fonts are served from the same custom directory as the CSS, so no external CDN is needed.

---

## Installing on TrueNAS Scale

TrueNAS Scale runs Gitea as a Docker container via the app catalog. The custom directory (`GITEA_CUSTOM`) is set to `/data/gitea` inside the container. Custom theme files go at:

```
$GITEA_CUSTOM/public/assets/css/theme-fell.css
$GITEA_CUSTOM/public/assets/fonts/*.ttf
```

### 1. Copy the theme files

Open a shell into the Gitea container. In the TrueNAS web UI, go to **Apps → Gitea → ⋮ → Shell**, then:

```sh
# Create directories if they don't exist
mkdir -p data/public/assets/css
mkdir -p data/public/assets/fonts
```

Then from your TrueNAS host shell (or via SCP), copy the files from this repo into those paths. If your Gitea data is on a host-path dataset (e.g. `/mnt/tank/gitea`), you can copy directly on the host:

```sh
# On the TrueNAS host — adjust the dataset path to match your setup
GITEA_DATA=/mnt/tank/gitea

mkdir -p "$GITEA_DATA/public/assets/css"
mkdir -p "$GITEA_DATA/public/assets/fonts"

cp public/assets/css/theme-fell.css  "$GITEA_DATA/public/assets/css/"
cp public/assets/fonts/*.ttf          "$GITEA_DATA/public/assets/fonts/"
```

> **ixVolume vs host path**: If Gitea is using an ixVolume (the TrueNAS default), the data lives inside the opaque volume store. Use the container shell method in that case, or switch the Gitea app to use a host-path dataset so you can manage files directly.

### 2. Register the theme in app.ini

Edit `/data/gitea/conf/app.ini` inside the container (or the `conf/app.ini` file in your dataset on the host):

```ini
[ui]
THEMES     = gitea-light,gitea-dark,fell
DEFAULT_THEME = fell
```

Add `fell` to whatever list of themes you already have — don't remove the built-ins.

### 3. Restart Gitea

In the TrueNAS web UI: **Apps → Gitea → ⋮ → Restart**.

### 4. Select the theme

Go to **User Settings → Appearance**, pick **Fell** from the theme dropdown, and click **Update Theme**.

---

## Installing on a plain Docker / docker-compose instance

Mount the `public/` directory from this repo into your container at `$GITEA_CUSTOM/public/`:

```yaml
services:
  gitea:
    image: gitea/gitea:latest
    volumes:
      - ./gitea-data:/data
      - ./public:/data/gitea/public   # ← this repo's public/ dir
    environment:
      - GITEA__ui__THEMES=gitea-light,gitea-dark,fell
      - GITEA__ui__DEFAULT_THEME=fell
```

---

## Font credit

The Fell Types are digitally reproduced by [Igino Marini](https://iginomarini.com/fell/) and are used here under their original license terms.