nullptr

A Matrix client with a focus on simplicity and elegance. Forked from Cinny.

Getting started

The web app is available at app.zeroprocess.de.

Self-hosting

To host nullptr on your own, simply download the tarball from GitHub releases, and serve the files from dist/ using your preferred webserver.

• The default homeservers and explore pages are defined in config.json.

• You need to set up redirects to serve the assets. Example configurations; netlify, nginx, caddy.

  • If you have trouble configuring redirects you can enable hash routing — the url in the browser will have a /#/ between the domain and open channel (ie. app.zeroprocess.de/#/home/ instead of app.zeroprocess.de/home/) but you won't have to configure your webserver.

• To deploy on subdirectory, you need to rebuild the app yourself after updating the base path in build.config.ts.

  • For example, if you want to deploy on https://zeroprocess.de/app, then set base: '/app'.

Local development

Tip

We recommend using a version manager as versions change very quickly. You will likely need to switch between multiple Node.js versions based on the needs of different projects you're working on. NVM on windows on Windows and nvm on Linux/macOS are pretty good choices. Recommended nodejs version is Iron LTS (v20).

Execute the following commands to start a development server:

npm ci # Installs all dependencies
npm start # Serve a development version

To build the app:

npm run build # Compiles the app into the dist/ directory

Running with Docker

This repository includes a Dockerfile, which builds the application from source and serves it with Nginx on port 80. To use this locally, you can build the container like so:

docker build -t nullptr:latest .

You can then run the container you've built with a command similar to this:

docker run -p 8080:80 nullptr:latest

This will forward your localhost port 8080 to the container's port 80. You can visit the app in your browser by navigating to http://localhost:8080.