# Paperback-Theme-Editor-UI

![Version 1.1](https://img.shields.io/badge/version-1.1-7FFF00)
![iOS](https://img.shields.io/badge/platform-iOS-7851A9)

# **[Open the live editor](https://chimeragaming.github.io/Paperback-Theme-Editor-UI/)**

Make a Paperback theme in your browser and see the colors change as you edit.
Nothing to install, no account needed, and no file upload required.
See your mistakes before you make them.

<img width="1894" height="927" alt="image" src="https://github.com/user-attachments/assets/64903bef-08e9-4d84-a126-9135e095a7ab" />

## How to use it

Open the live editor in your browser.

1. Start with the included theme, or optionally import your own `.pbcolors` file.
2. Choose Light or Dark and edit the colors and opacity.
3. Pick a device and preview Home, Library, Search, title details, or Settings.
4. Give your theme a file name and choose **Export .pbcolors**.

Both light and dark colors are included in the exported file. Imported files
are read on your device and are not uploaded to a server.

## On iPhone or iPad

Export opens the share sheet when supported. Choose Paperback if it appears,
or **Save to Files**. You can also download the file and share it from Files.
Keep the `.pbcolors` extension.

The editor saves a draft in your browser. Export a copy to keep it if you clear
browser data or change devices.

## About the preview

The preview is based on Paperback v0.9-r217 screenshots. System effects and
some color placement can differ from the app.

I am not affiliated with the Paperback team. This is an independent project
and is not an official or endorsed Paperback tool.

<details>
<summary>Development</summary>

These commands are for contributors. People using the published site only
need a browser.

With Node.js 24 or later:

```text
node serve.mjs
```

Open [the local editor](http://127.0.0.1:4173). No packages or build step needed.

See [contributing](CONTRIBUTING.md), [tests](docs/checks.md), and
[GitHub Pages setup](docs/github-pages.md) for more information.

</details>

## Contributions
As of v1.1 this project is 100% Human Coded.
Led and maintained by ChimeraGaming. The maintainer decides
what belongs in the project and reviews pull requests.

Pull requests are welcome. Please:

1. Keep changes focused and explain what they fix.
2. Follow the plain writing, readable code, and simple interface style.
3. Keep the app browser-based, private, and usable on mobile.
4. Preserve theme data, licenses, and credits.
5. Check your work and report the results.

Read the full rules in [AGENTS.md](AGENTS.md) or [CLAUDE.md](CLAUDE.md), and the
[contribution guide](CONTRIBUTING.md), before submitting a pull request.

## Credits

Thanks to the [Paperback team](https://paperback.moe/) for the app and its theme
support, and to [Celarye](https://github.com/celarye) for the
[public themes and Python theme creator](https://github.com/celarye/paperback-themes).
That project provided the original format reference and the starter colors used here.
Thanks also to [LucifersCircle](https://github.com/LucifersCircle/theme-editor)
for the current theme format example and color-mapping research.

Apple's device specifications helped with the preview sizes. Source links are
in the [device notes](docs/devices.md). The sample covers and titles were made
for this editor. See [third-party notices](THIRD_PARTY_NOTICES.md) for the
included theme's copyright and license.

## License and Paperback reuse

This project uses the [MIT license](LICENSE).

The Paperback team is welcome to use, modify, and include this code in
Paperback, including in a closed-source version. MIT already permits that,
provided the required copyright and license notices are retained.

If the team requests it, I am also open to discussing a closed-source future
version of this project. Existing MIT releases remain under MIT, and any
third-party code or contributions must keep the permissions their authors gave.
