About

Twenty helps you manage and plan your open source projects with a standalone web application that's designed to run on localhost or within your local network. It is both easy to use, and easy to install.

Features

• Provides a command-line utility to start / stop a web server.
• Connect / disconnect a project from the command line.
• Designed to work offline. Binds to http://localhost:2020 by default.
• Lightweight stack with Ruby and SQLite3 being the primary runtime dependencies.
• Easy to install, easy to use.
• Optional: nginx support via an unix socket.

Design

• The server is powered by rack and puma:
  • Accepts GraphQL requests at /graphql.
  • Serves client (HTML, JS, CSS).
  • Dependencies: Sequel, SQLite3, ruby-graphql.
• The client is a statically compiled nanoc website:
  • Dependencies: webpack, typescript, react.
• The CLI controls the web server:
  • Start / stop web server.
  • Run database migrations.
  • Run developer console.
• Each component (server, client, cli) are separate packages in a monorepo.
• Easy to distribute as a RubyGem.

Usage

CLI

Usage: twenty COMMAND [OPTIONS]

Commands:
  up             Start the twenty web server.
  down           Stop the twenty web server.
  connect        Connect a project to twenty.
  disconnect     Disconnect a project from twenty.
  migrate        Migrate the database.
  console        Start the twenty developer console.

Install

Twenty is distributed as a RubyGem.

$ gem install twenty.rb

Sources

• GitHub
• GitLab

License

BSD Zero Clause.
See LICENSE