Intent Clients

Official clients for Intent — open-source, privacy-first chat platform.

Setup

cd web
npm install
cp .env.example .env    # configure your Intent server URLs
npm run dev             # localhost:5173

Requires Node.js 18+ and a running Intent server.

Commands

npm run dev        # dev server
npm run build      # production build
npm run lint       # eslint

Architecture

web/src/
  api/            REST client (auth, servers, channels, messages, members, invites)
  gateway/        WebSocket (MessagePack binary protocol)
  stores/         Zustand state (auth, servers, channels, messages, users)
  components/
    layout/       AppShell, ChannelSidebar
    channels/     CreateChannelModal, ChannelSettingsModal
    servers/      ServerSettingsModal
    messages/     MessageItem, MessageInput
    members/      MemberList
    invites/      InviteModal
    user/         UserBar
    common/       Modal
  pages/          Login, Register, Main, Join (invite accept)
  types/          TypeScript definitions
  utils/          Shared utilities (invite cache, etc.)

Stack

• React 19 + TypeScript + Vite
• Zustand for state
• Tailwind CSS
• React Router v7
• MessagePack over WebSocket

Clients

Client	Status
Web	Active development
Desktop (Tauri)	Planned

Contributing

See CONTRIBUTING.md

License

MIT