Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


A link management system - or maybe just a playground for reactjs, node and stuff ;)

Installed at

This project features:

  • react
  • redux
  • universal/isomorphic rendering
  • react-router
  • eslint
  • form based authentication
  • oauth1a / oauth2 / openid based authentication
  • REST API with jsonwebtoken
  • react-redux-form
  • CouchDB backend via nano
  • browserHistory
  • react-hot-loader
  • and a lot more ...

initial setup

database setup

Linky runs as a nodejs server, but also needs a couchdb as the data backend.

Install couchdb version 3 and import all views from build/couchdb/. It is recommended to import all views build/couchdb/linky into a couchdb linky and build/couchdb/linky-archive into linky_archive.

The easiest way to start and install the couchdb:


setup for search

If you want to use search from the menu you need to start a lucene server.

This needs to be installed as a search plugin in Couchdb. The script ./ is taking care of this search plugin as well.

dev setup

This starts a webserver at :8080 for the REST services, all static files and the on-the-fly generated bundle.js

npm run dev

=> open http://localhost:8080

When using nodemon instead of dev you start the server with a nodemon watcher underneath.

npm run nodemon

You can check the whole project via eslint and run all unit tests with

npm test

When the couchdb is up, you can run integration tests via

npm integrationtest

Playing with the REST service

See build/test for The following commands are supported:

  • createuser
  • authenticate
  • createlink [tag]
  • getlinks
  • deletelink "ID"
  • html [url]
  • hierarchy
  • export
  • me

On a freshly set up system just start with createuser => authenticate => createlink => getlinks.

Executing the integration tests in a docker environment

Go to build/docker and use ./

  • ./ local will use the current project
  • ./ git will checkout the master
  • ./ clean will clean temporary files

prod setup

Copy the config from server/util/

At least change the jwt private key!!!

To build the client side bundle.js:

export LINKY_PROPERTIES="your modified version of server/util/"
npm build

To start the server at :8080 without dynamic bundle.js generation:

export LINKY_PROPERTIES="your modified version of server/util/"
npm start


The server script has several parameters:


This parameter must either be production or development.

  • development: webpack builds are on demand and hot-loading
  • production: webpack must be executed separately before starting the server script


This parameter may either be web or rest.

  • web: the server only serves html/css/js files. The server doesn't start the REST interface. It uses the PROXY_BIND and PROXY_PORT (default: localhost:8081) to find the rest interfaces.
  • rest: the server only serves the rest interfaces. the server doesn't serve any html/css/js files.


Defines the port where the http server bindes to. Default 8080.


Defines the interface where the http server bindes to. Default localhost.


A file path to a json formatted property file. Is this parameter undefined the server uses ./server/util/ You need to set this variable for build and start.


Special parameter only used in integration tests. Defines the protocol, server and port for the linky server. Default: http://localhost:8080


  • HEAD: *, delivers just 200:
  • NODE
    • /auth
    • /authback
    • /leave
    • /rest/*
    • /archive/*
    • /static/*
  • everthing else delivers the server-side pre-rendered html page from NODE
    • /
    • /links/:tag
    • /contact
    • /tags


  • All archived links are delivered by node (instead of just being a static file) to check that they belong to the current user.
  • Archived files may be deleted, as they are retrieved from couchdb on request if not available on the filesystem
  • It is strongly recommended to use a different domain for the archive, otherwise an archived page could steal your authentication token (cookie). The domain can be configured in server/util/


Link management system





No packages published