Skip to content

pakoito/cider

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CIDEr

Card IDE (CIDEr) - Design game cards using HTML/Handlebars, CSS, and tabular data.

Website: Start using Cider

About CIDEr

Cider was created to fill a niche between ease-of-use and versatility. The current market of board game/card creating applications seems to fit into two categories: 1) advanced software with a steep learning curve and hundreds of pages of documentation, and 2) user-friendly graphical interface, but limited versatility. Cider is absolutely closer to the first category in execution since it currently provides no graphical template editor, but it makes up for the learning curve by using a templating language that many are already familiar with (HTML/Handlebars and CSS).

1. Template

Create a template for each of the varying card fronts and card backs using HTML/Handlebars and CSS. Use variables to reference attributes that are unique to each card. Use control logic to conditionally display specific parts of the template.

screen-1

1.1 Built-in Handlebars Helpers

Built-in helpers reference

1.2 Card Attributes and Assets

Card Attributes

Reference any card attribute (names are in kebab case Ex. 'Mystic Power' -> 'mystic-power').

{{card.mystic-power}}

Assets

Reference any asset (names are in kebab case Ex. 'Apple Image' -> 'apple-image').

<img src="{{assets.apple-image}}"/>

1.3 Basic Helpers

Index {{index}}

Index an object/array with another variable (Ex. assets[card.image]).

{{index assets card.image}}

Compile Images {{compileImages}}

Compile text containing {{asset-name}} variables.

{{compileImages card.description width=100}}

Ex. Description Field

Convert up to two {{apple}} into a {chip}} each

image-1

Alternatively you can specify a multiplier to display multiple of a single image.

Convert {{apple 2}} into {{chip}}

1.4 Control Helpers

Repeat {{repeat}}

Repeat the contained HTML n number of times.

{{#repeat 5}}
    Any arbitrary HTML
{{/repeat}}

1.5 Boolean Helpers

AND {{and}}

{{#if (and (eq card.type "mystic") (gt card.power 4))}}
{{/if}}

OR {{or}}

{{#if (or (eq card.type "mystic") (gt card.power 4))}}
{{/if}}

1.6 Comparison Helpers

Equal {{eq}}

{{#if (eq card.type 'mystic')}}
{{/if}}

Greater Than {{gt}}

{{#if (gt card.power 5)}}
{{/if}}

Greater Than or Equal to{{gte}}

{{#if (gte card.power 5)}}
{{/if}}

Less Than {{lt}}

{{#if (lt card.power 4)}}
{{/if}}

Less Than or Equal to {{lte}}

{{#if (lte card.power 4)}}
{{/if}}

1.7 String Helpers

Concatenate {{concat}}

{{concat card.type "-experience"}}

Kebab-Case {{kebabcase}}

{{kebabcase "Clear Orb"}}

Upper-Case {{uppercase}}

{{uppercase "Clear Orb"}}

Lower-Case {{lowercase}}

{{lowercase "Clear Orb"}}

Pad Zeros {{padZeroes}}

Pad a given number by n zeros.

{{padZeros card.id 3}}

1.8 Math Helpers

Add {{add}}

{{add card.power 2}}

Subtract {{sub}}

{{sub card.power 2}}

Multiply {{multiply}}

{{multiply card.power 2}}

Divide {{divide}}

{{divide card.power 2}}

Ceiling {{ceil}}

{{ceil card.power}}

Floor {{floor}}

{{floor card.power}}

Absolute Value {{abs}}

{{abs card.power}}

2. Tabulate

Create attributes relevant to your game and fill out their values for each card. Choose the front and back templates for each card.

screen-2

3. Preview

Preview the way the cards look with the tabular data applied to the templates.

screen-3

4. Export

Export the cards as individual images (PNG), or as card sheets ready to print (PDF). Adjust the paper size, paper margins, and spacing between cards.

screen-4

Creative Ownership

Anything you create using CIDEr is your own intellectual property. The website hosts nothing and all of your card data and assets sit in IndexedDB on your browser. You may export and import your entire database to a .json file to use between devices. You may host your own version of the CIDEr website by downloading the source code and running npm install && ng serve.

The repository itself is protected by AGPL-3.0 to ensure the project remains open-sourced.

About

Card IDE (CIDEr) - Design game cards using HTML/Handlebars, CSS, and tabular data

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 73.8%
  • HTML 17.6%
  • SCSS 7.6%
  • JavaScript 1.0%