vanyapr/makaroshki

Macaroni Messenger is a chat application that lives entirely in a single HTML file and uses git repositories as its storage layer. Instead of a dedicated server or database, every message gets written as a commit to a repository of your choice, hosted on GitHub, GitLab, GitVerse, Gitea, or Forgejo. To use it, you download the one HTML file and open it in Chrome, Chromium, or Edge. From there, you connect a repository by providing your git host, the repository URL, and a personal access token with read/write permission. Once connected, you can send and receive messages in that repository's chat. A live demo is available that shows pre-loaded conversations without needing an account or token. Messages are stored under a .macaroni/ folder inside whichever repository you connect, so the messenger can sit alongside any existing project without interfering with it. The structure organizes chats, members, and individual messages into dated subfolders. Because the storage is just a git repository, the privacy level depends entirely on whether that repository is public or private. The README is honest about the trade-offs. There is no real-time push transport: the app polls for new messages. Tokens are kept in browser localStorage, which is convenient but not a secure store. Large chat histories in a single repository will get slow, and the recommended fix is simply to create another repository. CORS restrictions on self-hosted instances may prevent the browser-side adapters from working, depending on the server configuration. The project has no build step and no backend. It is released under the WTFPL license.