core

README

What is Anzu?

Anzu is an open source software project designed to create communities. Simple, reactive, and performant forums software.

This repository contains the core backend code and the frontend as a git submodule inside static/frontend.

The system is a WIP and while usable things might change dramatically.

Anzu's stack

• Go programming language
• redis (required) for cache
• mongoDB (required)
• react for the webapp

Contribute

Installation

Download dependencies

The first step is to download Go, official binary distributions are available at https://golang.org/dl/.

Now you need to download and configure MongoDB and Redis. Alternatively you can use remote servers.

Download the repositories

Download the core in any path.

Initialize the repo submodule, so the frontend is in static/frontend.

git submodule update --init --recursive

Configure

Copy the .env.example file into .env and edit it to meet your local environment configuration.

Run MongoDB with docker compose

Start a local MongoDB 3.1 server with the help of docker and docker compose, ensure you have docker installed and then run: docker compose up

Last steps

Building the frontend before getting started is required, to do so, execute npm install && npm run build inside static/frontend submodule. Once the frontend is built you can build the backend program with go build -o anzu and then execute ./anzu api to run anzu's http web server.

If you are running anzu for the first time you should be able to log-in with the credentials:

username: admin@local.domain 
password: admin

Commits

We follow the Conventional Commits specification, which help us with automatic semantic versioning and CHANGELOG generation.