The open-source Document Lifecycle Management platform.

Wraft - Document Lifecycle Management

Wraft is an open-source content authoring platform that's helps businesses produce their most important set of documents. Wraft helps author structured business content. From official letters to contracts, and beyond.

Our goal is to give people complete control over their most important documents, from drafting to collaborating and distributing.

Wraft is built on top of open formats, using markdown and JSON. This means your content is always accessible and future-proof.

Table of contents

• Wraft
• Table of contents
  • Development
    • Pre-requisite
    • Initial setup
  • Running Wraft
  • Testing Wraft
  • Others
    • Few additional mix tasks

Development

Pre-requisite

• Elixir 1.18.4
• Erlang/OTP 27.0.1
• Postgres
• Minio - S3 compatible object storage
• Pandoc 3.6.3
• ImageMagick
• Latex
• Typst 0.13.0
• Java 17 (for PDF signing)
• Rust toolchain (for native dependencies)

.tool-versions will have the exact versions defined in it.

Initial setup

1 - Clone the repository

$ git clone https://github.com/wraft/wraft.git
$ cd wraft

2 - Elixir & Erlang

As these 2 are defined in the .tool_versions, asdf will install the right versions with the following set of commands:

Please refer the given link for the installation of asdf-version-manager.

Add the following plugins to your asdf for elixir and erlang:

$ asdf plugin add erlang https://github.com/asdf-vm/asdf-erlang.git

$ asdf plugin add elixir https://github.com/asdf-vm/asdf-elixir.git

$ asdf install

⚠️ For Ubuntu users, you also need to install the inotify-tools package.

inotify-tools

• command-line utilities to monitor file system activity

In macOS:

$ brew install inotify-tools

In Linux:

$ sudo apt install inotify-tools

3 - Postgres

Select your OS from the options here and follow the instruction to install the latest version of postgres. Check your installation using:

$  postgres -V

Test your connectivity:

$ psql -h 127.0.0.1 -p 5432 -U postgres postgres

4 - Minio

Download the latest version of minio from here and follow the instructions to install based on your OS.

Run the following command from the system terminal or shell to start a local MinIO instance using the ~/minio folder. You can replace this path with another folder path on the local machine:

$ minio server ~/minio
$ minio server ~/minio --console-address :9001

Open http://127.0.0.1:9000 in a web browser to access the MinIO Console.

5 - Pandoc

macOS

The easiest way to install it on OSX is via brew:

$ brew install pandoc

Linux

For Linux machines, follow the instructions below.

• Download the pandoc package that suits your device here
• To install the deb:

$ sudo dpkg -i $DEB

where $DEB is the path to the downloaded deb.

These instructions are taken from Official Pandoc Documentations. You may refer if the official documentation if you have any doubts.

6 - ImageMagick

To use ImageMagick, install the ImageMagick distribution from here appropriate to your OS.

For linux:

sudo apt update
sudo apt install imagemagick

7 - Latex

To use Latex in OSX, install the MacTex Distribution. You can download MacTex here. Choose the correct version that supports your device, download and install. Latex editor comes with the distribution.

In Linux machines, we suggest to use Tex Live LaTeX distribution. Easiest way to install Tex Live distribution in Linux/Ubuntu is to use apt-get.

$ sudo apt-get install texlive-full

In case you need latex editor, type in:

$ sudo apt-get install texmaker

8 - Typesense

Typesense is a fast, typo-tolerant search engine used by Wraft for search functionality.

For detailed installation instructions, refer to the official Typesense documentation.

Download from Typesense releases or run manually:

$ mkdir -p ~/typesense-data
$ typesense-server --data-dir ~/typesense-data --api-key=your-api-key-here

Note: Replace your-api-key-here with a secure API key. Default port is 8108.

9 - Running Wraft

To start your Wraft app:

Load env variables

Make a .env.dev file in the root directory and add the environment variables. Refer .env.example for the list of variables.

Source the environment variables from the file and start the server.

$ mv .env.example .env.dev
$ source .env.dev

Setup the project

$ mix setup

Start Phoenix endpoint

• With interactive shell

$ iex -S mix phx.server

• Without interactive shell

$ source .env.dev && mix phx.server

Now you can visit localhost:4000 from your browser.

To get the API documentation, go here.

10 - Frontend

Clone the frontend repository separately.

$ cd ..
$ git clone https://github.com/wraft/wraft-frontend.git
$ cd wraft-frontend

Refer the README.md in the frontend repository for the setup.

11 - Default User

The default username and password

username: wraftuser@gmail.com
password: demo@1234

---

Setup using Docker Compose

The easiest way to get started with Wraft is using Docker. The Docker setup includes all required dependencies and services.

Prerequisites

• Docker and Docker Compose installed on your system
• Git

Quick Start

1. Clone the repository and navigate into it

git clone https://github.com/wraft/wraft.git
cd wraft

2. Copy the example environment file and update it

cp .env.example .env.dev

3. Load environment variables

source .env.dev

4. Add MinIO host entry

# macOS / Linux
echo "127.0.0.1 minio" | sudo tee -a /etc/hosts

# Windows
echo 127.0.0.1 minio >> C:\Windows\System32\drivers\etc\hosts

5. Start all Docker containers

docker-compose up -d

6. Visit the application

# Frontend
open http://localhost:3200

Default Credentials

username: wraftuser@gmail.com
password: demo@1234

What's Included

The Docker setup includes:

• Backend: Elixir 1.18.4 with Erlang 27.0.1
• Frontend: React application
• Database: PostgreSQL 14
• Object Storage: MinIO (S3-compatible)
• Search Engine: Typesense
• Dependencies: Pandoc 3.6.3, Typst 0.13.0, LaTeX, ImageMagick, Java 17, Rust toolchain

Services and Ports

• Frontend: http://localhost:3200
• Backend API: http://localhost:4000
• MinIO Console: http://localhost:9001
• PostgreSQL: localhost:5433
• Typesense: localhost:8108

Environment Variables

Make sure to configure the following environment variables in your .env.dev file:

• SECRET_KEY_BASE
• DEV_DB_USERNAME, DEV_DB_PASSWORD, DEV_DB_NAME
• MINIO_ROOT_USER / MINIO_ROOT_PASSWORD
• TYPESENSE_API_KEY
• CLOAK_KEY
• GUARDIAN_KEY
• And other required variables (see .env.example)

Stopping the Services

$ docker-compose down

To remove all data volumes as well:

$ docker-compose down -v

License

Wraft is open-source software licensed under the AGPLv3.