Temas: escolha um visual ou traga o seu.

1. 1Coloque um arquivo de tema no seu telefone. Ele termina em .json e tem menos de 64 KiB.
2. 2Em Configurações, abra o cartão Tema sob Aparência, toque em Importar e escolha o arquivo.
3. 3Leia a prévia. Ela mostra as cores de ambas as metades, a forma, as cores do terminal e um relatório de contraste. Um contraste fraco exibe um aviso, e você ainda pode aplicar o tema. Um arquivo que viola as regras é recusado, e nada é alterado.

Um tema altera a aparência do aplicativo e nada mais. Ele não pode executar código, carregar arquivos ou se comunicar com um servidor.

Um dispositivo mantém até oito temas importados. Não há importação por link, e os temas não são sincronizados entre dispositivos.

{
  "version": 2,
  "id": "harbour",
  "name": "Harbour",
  "author": "Collie",
  "light": {
    "background": "oklch(0.95 0.01 235)",
    "foreground": "oklch(0.26 0.025 250)",
    "card": "oklch(0.985 0.004 235)",
    "...": "..."
  },
  "dark": {
    "background": "oklch(0.21 0.018 250)",
    "foreground": "oklch(0.93 0.012 240)",
    "card": "oklch(0.255 0.02 252)",
    "...": "..."
  },
  "fonts": { "ui": "atkinson", "display": "grotesk" },
  "surface": {
    "radius": "soft",
    "shadow": "lifted",
    "density": "default",
    "weight": "default",
    "border": "default",
    "ground": "grain",
    "chrome": "page",
    "rows": "rules",
    "icons": "thin",
    "labels": "caps"
  },
  "ansi": {
    "0": "#073642",
    "1": "#f0504a",
    "2": "#859900",
    "...": "..."
  }
}

Os 43 tokens

Um arquivo de tema pode nomear apenas estes tokens, divididos em quatro grupos. Um arquivo com qualquer outra chave é recusado.

Forma e aparência

O bloco surface contém dez palavras. Cada uma vem de uma lista fechada, e um token omitido mantém seu padrão, a primeira palavra da sua lista. Um número avulso nunca é aceito, logo um tema não pode quebrar um tamanho de toque.

radius

O canto de um cartão, de uma linha, de um campo e de um botão.

• sharp
• soft
• round

shadow

A sombra sob painéis elevados.

• default
• flat
• lifted

density

Quanto espaço existe dentro e entre os controles.

• default
• roomy

weight

O peso com que o texto em medium e semibold é renderizado.

• default
• bold

border

A espessura de uma linha fina.

• default
• strong

ground

A página por trás de tudo: plana, um gradiente suave ou um granulado fino.

• flat
• gradient
• grain

chrome

O cabeçalho e as barras: na cor da página ou em uma faixa própria.

• page
• band

rows

Uma lista como um grupo emoldurado com regras, ou como um cartão para cada linha.

• rules
• cards

icons

A espessura do traço de cada ícone.

• default
• thin
• heavy

labels

Rótulos pequenos de seção, em maiúsculas ou em estilo frase.

• caps
• sentence

Paleta do terminal

O bloco ansi contém 18 cores ou nenhuma: as 16 cores do terminal, ink e ground. Cada uma é #rrggbb ou oklch(L C H), e cada uma passa por uma validação.

Valores

Um valor é uma cor: #rrggbb, #rrggbbaa ou oklch(L C H), com / A para opacidade. L varia de 0 a 1, C de 0 a 0.5 e H de 0 a 360, todos como números simples.

Metades

Forneça light, dark ou ambos. A metade que você omitir é preenchida a partir do Collie, token por token.

Fontes

O campo opcional fonts.ui define uma das fontes que o ColliePWA inclui. O campo opcional fonts.display define uma fonte para títulos. Nenhuma outra fonte é aceita.

O que é recusado

Uma chave fora da lista, uma versão diferente de 1 ou 2, um valor que não seja uma cor ou palavra de forma, var(), url() ou qualquer outra função, o id de um tema nativo e um arquivo com mais de 64 KiB. A mensagem indica a causa, e nada é aplicado.

Versão

version é 1 ou 2. Um arquivo com um bloco surface, uma fonte fonts.display ou um bloco ansi indica 2. Um arquivo version 2 requer o ColliePWA 1.22.0 ou mais recente.

A exportação grava o tema ativo como um arquivo .collie-theme.json. Envie para alguém, ou mantenha em um repositório, e essa pessoa importa da mesma forma que você fez.

Detalhes em Temas