# Cadernita

> Um caderno digital feito de notas em sequência. Cada nota nasce de um **molde**
> — um pequeno formulário com aparência e comportamento próprios. O molde é a
> caneta; a nota é o que fica escrito.

Qualquer pessoa pode escrever os próprios moldes e instalá-los, sem conta, sem
compilar nada e sem acesso ao código do projeto. Um molde é um arquivo JSON.

## Para criar um molde

Comece pela galeria: **https://cadernita.com/moldes.md** lista os trinta e três
moldes de fábrica. Escolha três e leia as fichas antes de desenhar — cada uma
traz o código inteiro do molde. A especificação diz o que o validador recusa; a
galeria é o único lugar onde se vê um molde bom, e sem ela sai sempre a mesma
forma: uma linha curta em cima e um campo de texto embaixo.

Depois leia **https://cadernita.com/criar-moldes.md**. Ele traz a especificação
completa: o formato do pacote, o contrato da função de montagem, e as regras que
o validador exige — que são rigorosas, então um molde escrito de memória
costuma ser recusado.

**Valide antes de entregar**, quantas vezes precisar — é o mesmo validador que
roda dentro do aplicativo, e ele não guarda nada:

```sh
curl -X POST https://cadernita.com/validar \
  -H 'Content-Type: application/json' \
  --data-binary @meu-molde.json
```

Produza **um arquivo `.json`** e entregue-o de um destes jeitos:

- salve dentro de `inbox/` na pasta que a pessoa conectou à Cadernita, e ela
  verá a proposta no painel de paletas;
- ou salve em qualquer lugar, e a pessoa arrasta o arquivo para
  https://cadernita.com, cola com Ctrl+V, ou o escolhe em "abrir caderno
  recebido".

Se o pacote for recusado, a Cadernita mostra o diagnóstico com código, linha e
coluna. Corrija por ele: as mensagens são específicas.

## O que um molde não pode fazer

Moldes rodam isolados, e o validador recusa o que fuja disso: sem rede
(`fetch`, `WebSocket`, …), sem armazenamento próprio (`localStorage`,
`indexedDB`), sem `eval` nem `Function`, e sem alcançar a página que os contém.
Toda escrita no DOM precisa ter alvo provadamente dentro do próprio molde.

## Links

- Galeria dos moldes de fábrica: https://cadernita.com/moldes.md
- Especificação de moldes: https://cadernita.com/criar-moldes.md
- Validador: POST https://cadernita.com/validar
- Aplicativo: https://cadernita.com
- Código: https://github.com/canpse/cadernita