For more information about the inspiration, you can read more about it in this link. There’s also a video from the creator of this idea which you can see it right here.
-
It’s mostly built as an offline app so once you’ve visited the app, you’ll be ready to go. No installation required.
-
Being a progressive web app (PWA), you can even make it almost like a native mobile app on your phone by adding the app page into the home screen.
-
-
Defining your own set of virtual idea dice set (or VIDS, as I call them).
-
Storing VIDS in IndexedDB (with localforage).
-
Import and export of VIDS with a JSON file
-
You can see some sample dice sets in the
examples/directory and import them to see it. Be sure to export your dice set first since the app can only have one set (at least for now).
-
-
Saving dice results in IndexedDB (with localforage).
If you want to open this app locally on your machine, just do the following:
-
clone this repo or download the zip of this repo provided
-
fetch the files from the dev (
develop) branch -
install all of the dependencies needed (
npm i) -
open the app over
localhostwithnpm run serve
Aaaaaaaand voila! It’s open now! 😁
If you want to contribute or just add features that you want, take note of the following configurations:
-
created with Vue CLI and the official Vue router library
-
uses Tailwind CSS for most of the CSS
-
uses ESLint and it has the standard style guide as the configuration
-
all of the usual configurations and constants like the routes, app information, and the author are located in
./src/constants.js, I’ve made it so that I can update it easily in one place
If you want to contribute through code, you can look at the changelog
in the dev (develop) branch for the latest features that has been implemented so far.
Also, it contains some future features that is to be considered.
If you want to contribute through writing and/or improving documentations, have a quick look at Asciidoctor since it is the formatting language used for writing docs around here. It’s basically a (more comprehensive) alternative to Markdown.
Speaking of Markdown, you can take a good look here if you’re familiar with Markdown for a quick start.
If you want to report bugs or suggest a feature, you can file an issue in the issue tracker.
Just make sure the title is brief and concise with the type of issue you’re filing (bug, feature, enhancement, etc.) and leave all the details in the body of the issue.
Big shoutout to Atomic Shrimp's Invention Dice project for the main inspiration for this project. Also, I’ve got this project to be featured (at 4:15 mark) by the man behind the idea himself. :)
Icons used from IconMonstr and Freepik.
-
Multiple virtual idea dice set (VIDS) support
-
A VIDS ranking system (see this issue) — This is mostly be implemented as an optional feature since the app is built to be offline and this mostly requires the user to be online. Though with online capability, it is yet to be one of the biggest features to be implemented so far.
-
Improve UI/UX — I especially need some help from this one. ;-;