• Blog
  • Docs
  • Pricing
  • We’re hiring!
Log inSign up
loading

loading

matrix

simple matrix client
Public
Like
matrix
Home
Code
4
backend
1
frontend
3
shared
1
README.md
Branches
1
Pull requests
Remixes
History
Environment variables
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Sign up now
Code
/
README.md
Code
/
README.md
Search
5/29/2025
Viewing readonly version of main branch: v14
View latest version
README.md

Matrix Client

A web-based Matrix client built with React and TailwindCSS.

Features

  • Connect to any Matrix homeserver
  • Login with username/password
  • View and join rooms
  • Send and receive messages
  • Real-time message updates
  • Responsive design with TailwindCSS

Project Structure

├── backend/
│   └── index.ts             # Proxy server for Matrix API (CORS handling)
├── frontend/
│   ├── components/
│   │   ├── App.tsx          # Main application component
│   │   ├── Login.tsx        # Login form
│   │   ├── RoomList.tsx     # List of joined rooms
│   │   ├── ChatView.tsx     # Chat interface
│   │   ├── MessageList.tsx  # Message display
│   │   └── MessageInput.tsx # Message composition
│   ├── index.html           # Main HTML template
│   └── index.tsx            # Frontend entry point
├── shared/
│   └── types.ts             # Shared TypeScript types
└── README.md

Usage

  1. Open the application
  2. Enter your Matrix homeserver URL (e.g., https://matrix.org)
  3. Login with your Matrix credentials
  4. Browse rooms and start chatting!

Features Implemented

  • ✅ Responsive login form with homeserver selection
  • ✅ Room list with real-time updates
  • ✅ Message history loading
  • ✅ Real-time message sync
  • ✅ Send text messages
  • ✅ Message grouping by date
  • ✅ User avatars and display names
  • ✅ Optimistic message sending
  • ✅ Auto-scrolling to new messages
  • ✅ Session persistence
  • ✅ Beautiful TailwindCSS styling

Technical Details

  • Backend: Hono-based proxy server to handle CORS issues with Matrix homeservers
  • Frontend: React SPA with TailwindCSS for styling
  • Real-time: Polling-based sync for new messages
  • Storage: LocalStorage for session persistence
  • API: Matrix Client-Server API v1.0

Development

The backend serves as a proxy to handle CORS issues with Matrix homeservers. All Matrix API calls are proxied through /api/matrix/* endpoints.

FeaturesVersion controlCode intelligenceCLIMCP
Use cases
TeamsAI agentsSlackGTM
DocsShowcaseTemplatesNewestTrendingAPI examplesNPM packages
PricingNewsletterBlogAboutCareers
We’re hiring!
Brandhi@val.townStatus
X (Twitter)
Discord community
GitHub discussions
YouTube channel
Bluesky
Open Source Pledge
Terms of usePrivacy policyAbuse contact
© 2026 Val Town, Inc.