Featmap, the simple user story mapping tool

Featmap is a simple user story mapping tool for product managers to build, plan and communicate product backlogs. It is built using React, Typescript and Go. Try it out at www.featmap.com.

How to run locally

Database requirements

Featmap runs on top of PostgreSQL, so make sure you have it running on your system.

Downloading

Download the Featmap binary for your respective platform and save it somewhere on your system.

Configuration

In the directory where you placed the binary, create a file called conf.json.

Here's a sample conf.json

{  
  "appSiteURL": "http://localhost/",
  "dbConnectionString": "postgresql://featmap:featmap@localhost:5432/featmap?sslmode=disable",
  "jwtSecret": "mC3qd44x5hr5YaRhaj5pM5L",  // replace by your own secret!
  "port": "80",
  "emailFrom" : "[email protected]",
  "smtpServer" : "smtp.example.com",
  "smtpUser" : "[email protected]",
  "smtpPass": "some_smtp_password"
}

Setting	Description
appSiteURL	The url to where you will be hosting the app.
dbConnectionString	The connection string to the PostgreSQL database that Featmap should connect to.
jwtSecret	This setting is used to secure the cookies produced by Featmap.
port	The port that Featmap should run on.
emailFrom	The email adress that should be used as sender when sending invitation and password reset mails.
smtpServer	SMTP server for sending emails.
smtpUser	SMTP server username.
smtpPass	SMTP server password.

It is possible to run Featmap without filling in the mail details, but recovery emails and workspace invites will not be available.

Running

Execute the binary.

./featmap-1.0.0-linux-amd64
Serving on port 80

Open a browser to http://localhost and you are ready to go!

Building

Requirements

The following must be installed on your system in order to build

• Node.js
• Go
• go-bindata

Instructions

Start by cloning the repository.

git clone https://github.com/amborle/featmap.git

Navigate to the repository.

cd featmap

Now let's build it (requires Bash).

./build/complete_build.sh

Binaries for Linux, Win and Mac are now available in the bin folder.

cd bin
ls
featmap-1.0.3-darwin-amd64  featmap-1.0.3-linux-amd64  featmap-1.0.3-windows-amd64.exe