Welcome to Angry Cat!

Angry Cat is an effective client for conversing with your peers using Zulip. (It is all client-side TypeScript code talking directly to a server.)

We are hosted now (as of March 2026) on Github Pages and our primary Zulip server is macandcheese.

Initial setup

Install vite:

npm install vite --save-dev

Install oxlint:

npm add -D oxlint

Install biome:

npm i -D --save-exact @biomejs/biome

Create a local src/test_config.ts file

Create a file like this named src/test_config.ts in order to use node for running ad-hoc queries against our model.

export const TEST_CONFIG = {
    nickname: "test",
    url: "https://macandcheese.zulipchat.com/",
    email: "showell30@yahoo.com",
    api_key: "KjGWo1SFREDCUYnbXl7mFREDsbRdDORP",
};

Development workflow

I usually keep 4 terminals open:

• npm run dev # listens on 7888 usually
• npx tsc -w --noEmit # shows TS errors
• run my editor
• use git commands (and other command-line stuff)

I also lint every now and then:

• npm run lint
• npm run format

Tests

• npm run test

Node stuff (in progress)

We don't heavily use node yet, but it's occasionally useful for ad-hoc testing (automated or manual).

Install vite-node:

npm install vite-node --save-dev

Then do:

npm run test
npm run fetch

GH Pages

We deploy this with GH Pages. More details to come.