Skip to content

Commit 576c455

Browse files
authored
Merge pull request #1 from lomefin/master
unchilenizes the readme
2 parents 781e3cb + 7ef37b8 commit 576c455

3 files changed

Lines changed: 22 additions & 19 deletions

File tree

CHANGELOG.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
# CHANGELOG
22

3+
## [0.1.3] - 2025-09-23
4+
5+
- Unchilenizes the README file
6+
37
## [0.1.2] - 2025-09-11
48

59
### Added

README.md

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
# Command Deck
22

3-
![Demo](public/img/demo.gif)
3+
Convenient, unobstrustive, dev-oriented Rails engine that allows you to run custom action and quick admin taskss through a floating panel without the need for opening Rails console.
44

5-
Command Deck is a tiny, dev-only Rails engine that gives you a floating panel to run custom actions and quick admin tasks without opening Rails console.
5+
You define panels/tabs/actions with a minimal DSL. Each action can declare a few parameters (text, boolean, number, selector), run Ruby code, and return a JSON-ish result shown in the UI.
66

7-
You define panels/tabs/actions in a minimal DSL. Each action can declare a few params (text, boolean, number, selector), run Ruby code, and return a JSON-ish result shown in the UI.
7+
![Demo](public/img/demo.gif)
88

99
## Installation
1010

@@ -13,17 +13,16 @@ Add the gem to your application:
1313
```ruby
1414
# Gemfile (development only recommended)
1515
group :development do
16-
gem "command_deck"
16+
gem 'command_deck'
1717
end
1818
```
1919

20-
Mount the engine (dev only):
20+
Mount the engine:
2121

2222
```ruby
2323
# config/routes.rb
24-
if Rails.env.development?
25-
mount CommandDeck::Engine => "/command_deck"
26-
end
24+
25+
mount CommandDeck::Engine => '/command_deck' if Rails.env.development?
2726
```
2827

2928
Start your app and the floating panel should appear.
@@ -33,23 +32,23 @@ Start your app and the floating panel should appear.
3332
Create Ruby files in `app/command_deck/**/*.rb`. Example:
3433

3534
```ruby
36-
CommandDeck.panel "Utilities" do
37-
tab "Demo" do
38-
action "Greet", key: "utils.greet" do
39-
param :name, :string, label: "Your name", required: true
35+
CommandDeck.panel 'Utilities' do
36+
tab 'Demo' do
37+
action 'Greet', key: 'utils.greet' do
38+
param :name, :string, label: 'Your name', required: true
4039

4140
perform do |p, _ctx|
4241
{ message: "Hello, #{p[:name]}!" }
4342
end
4443
end
4544

46-
action "Pick a Color", key: "utils.color" do
45+
action 'Pick a Color', key: 'utils.color' do
4746
# You can pass simple arrays, pairs, or hashes as choices
4847
param :color, :selector,
4948
options: [
50-
["Red", "red"],
51-
["Green", "green"],
52-
["Blue", "blue"]
49+
['Red', 'red'],
50+
['Green', 'green'],
51+
['Blue', 'blue']
5352
],
5453
include_blank: true
5554

@@ -61,7 +60,7 @@ CommandDeck.panel "Utilities" do
6160
end
6261
```
6362

64-
This will create a panel called "Utilities" with a tab called "Demo" and two actions: "Greet" and "Pick a Color".
63+
This will create a panel called `Utilities` with a tab called `Demo` and two actions: `Greet` and `Pick a Color`.
6564

6665
![Demo](public/img/demo.png)
6766

@@ -112,7 +111,7 @@ Selector-specific options:
112111
- `return:` `:value` (default), `:label`, or `:both` (`{ label:, value: }`).
113112
- Choice shapes accepted:
114113
- Values: `%w[a b c]`
115-
- Pairs: `[["Label A", "a"], ["Label B", "b"]]`
114+
- Pairs: `[['Label A', 'a'], ['Label B', 'b']]`
116115
- Objects: `{ label:, value:, meta?: { ... } }`
117116

118117
Action execution:

lib/command_deck/version.rb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# frozen_string_literal: true
22

33
module CommandDeck
4-
VERSION = "0.1.2"
4+
VERSION = "0.1.3"
55
end

0 commit comments

Comments
 (0)