About

dolphins7 is a webskel skeleton. The Design section describes how it is organized.

Design

• The server/ is powered by Ruby
  • rack, graphql-ruby, and puma
  • The server provides the /graphql endpoint for client <-> server communication
  • The server serves static files (HTML, JS, CSS, ...) via puma (Ruby HTTP server)
  • The /graphql endpoint enters the graphql-ruby stack
• The client/ is powered by NodeJS
  • webpack, typescript, react, and react-router
  • The client produces a build/ directory
  • The client provides static files (HTML, JS, CSS, ...)
  • The client provides routes via react-router
  • The client communicates with the server via @apollo/client (GraphQL client)
• The cli/ is powered by Ruby
  • Start / stop web server
  • Run database migrations
  • Run developer console
  • Available as a RubyGem executable
• Each component (server, client, cli) are separate packages in a monorepo
• Easy to distribute as a RubyGem

Usage

CLI

Usage: cli COMMAND [OPTIONS]

Commands:
  up             Start the twenty web server
  down           Stop the twenty web server
  migrate        Migrate the database
  console        Start the twenty developer console

Install

user@localhost$ webskel new myapp dolphins7

Sources

• GitHub
• GitLab
• brew.bsd.cafe/@webskel

License

BSD Zero Clause.
See LICENSE