dungeonchurch/rpg-cards
dungeonchurch/rpg-cards
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Docker build & customized version for deployment https://rpg-cards.dungeon.church
427 commits 1 branch 0 tags 93 MiB
  • CSS 45.2%
  • JavaScript 38%
  • HTML 16.4%
  • Dockerfile 0.4%
Find a file
Exact
Brad Wenner 9d8770dbcd
All checks were successful
Build Docker Image / build (push) Successful in 2m13s
Details
fix stale Docker cache: add --no-cache to build commands 
The deployed ui.js was missing zoom code because Docker reused a
cached layer with old source files.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 16:12:43 -07:00
.forgejo/workflows fix stale Docker cache: add --no-cache to build commands 2026-03-25 16:12:43 -07:00
generator add 3D card zoom overlay with click-to-preview 2026-03-25 14:55:32 -07:00
resources add Dungeon Church dark theme MVP 2026-03-24 22:51:53 -07:00
.dockerignore add Dockerfile and docker-compose for self-hosting 2026-03-24 21:39:04 -07:00
.gitignore Add package-lock.json 2026-02-03 00:16:36 +01:00
docker-compose.yml update docker-compose to pull from Forgejo registry 2026-03-24 21:58:48 -07:00
Dockerfile add Dockerfile and docker-compose for self-hosting 2026-03-24 21:39:04 -07:00
LICENSE Add MIT license 2018-02-01 21:46:22 +01:00
nginx.conf add Dockerfile and docker-compose for self-hosting 2026-03-24 21:39:04 -07:00
package-lock.json Bump minimatch 2026-02-28 08:56:23 +00:00
package.json package.json update 2026-02-02 21:37:10 +01:00
README.md Update README.md 2026-02-02 22:07:55 +01:00

README.md

rpg-cards

RPG spell/item/monster card generator

Preview

Click here for a live preview of this generator.

Documentation

Click here to read the documentation.

Installation and Updating

This project consists almost exclusively of static HTML/CSS/JavaScript files, but it needs to be build at least one time to work.

The build will update /generator/icons folder with content from:

  • The game-icons project.
  • Fonts from the gameicons-font project.
  • And any .png or .svg files you have added to ./resources/custom-icons (you must build the project and refresh the page in the browser in order to use them).

To setup or update this project:

  1. Checkout this GIT repository
  2. Make sure you have Node.js installed. The Node installation usually bundles the npm command-line interface. We strongly recommend using a Node version manager like nvm to install Node.js and npm.
  3. Open the Terminal (or Command Prompt for Windows)
  4. Go to the repository folder
  5. Run npm install

To build this project:

  • Run npm run build

To lanunch the generator locally on your browser:

  • Run npm start to run the local HTTP server, then open one of the indicated URLs (e.g. http://localhost:8080) in your browser. Please use localhost instead of other aliases, since it is treated as a secure context. This enables access to more advanced JavaScript features.

To deply the generator into a website:

  • Deploy the content of the ./generator folder to your server (i.e. using an FTP client)

Support

I (the original author) am not maintaining the project anymore, and will not be responding to issues or reviewing PRs. However, I have given write access to a few collaborators that are maintaining the project. Please reach out to me if you want to be included as collaborator, or if you want to take ownership of this project.

FAQ

  • What browsers are supported?
    • A modern browser (Chrome, Edge, Safari).
    • IE and Firefox are not supported (Firefox due to privacy concerns).
  • Cards are generated without icons and background colors, what's wrong?
    • Enable printing backround images in your browser print dialog
  • The layout of the cards is broken (e.g., cards are placed outside the page), what's wrong?
    • Check your page size, card size, and cards/page settings. If you ask the generator to place 4x4 poker-sized cards on a A4 paper, they won't fit and they will overflow the page.

License

This generator is provided under the terms of the MIT License.

Icons are made by various artists, available at http://game-icons.net. They are provided under the terms of the Creative Commons 3.0 BY license.