dolphins7.skeleton/README.md

55 lines
1.5 KiB
Markdown
Raw Normal View History

2023-12-08 19:27:00 +01:00
## About
2024-01-14 05:59:30 +01:00
Twenty helps you manage your projects with a web application
2024-01-28 03:49:40 +01:00
that runs on your computer.
2023-12-08 19:27:00 +01:00
2023-12-22 22:23:10 +01:00
## Features
* Provides a command-line utility to start / stop a web server.
* Connect / disconnect a project from the command line.
2024-02-08 05:12:24 +01:00
* Works offline. Binds to `http://localhost:2020` by default.
2024-01-14 05:59:30 +01:00
* Minimal: Ruby, and SQLite3 are the primary runtime dependencies.
* Easy to install, easy to use.
2023-12-22 22:23:10 +01:00
2024-01-14 22:48:27 +01:00
## Design
* The server is powered by [ruby/webrick](https://github.com/ruby/webrick):
* Accepts GraphQL requests at `/graphql`.
* Serves client (HTML, JS, CSS).
* Dependencies: ActiveRecord, SQLite3, ruby-graphql.
* The client is a statically compiled [nanoc](https://github.com/nanoc/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.
2023-12-08 19:27:00 +01:00
## Usage
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.
2023-12-23 20:23:55 +01:00
migrate Migrate the database.
2023-12-26 03:12:57 +01:00
console Start the twenty developer console.
2023-12-08 19:27:00 +01:00
2024-01-24 21:04:30 +01:00
## Screenshots
![img](./20.png)
2023-12-08 19:27:00 +01:00
## Install
2024-02-08 00:10:53 +01:00
$ gem install twenty.rb
2023-12-08 19:27:00 +01:00
## License
[BSD Zero Clause](https://choosealicense.com/licenses/0bsd/).
<br>
See [LICENSE](./LICENSE)