Skip to content

A Collection of application ideas which can be used to improve your coding skills.

Feature: Add Shell game app specification

jdmedlockd944b42827c0
diff --git a/Projects/Shell-Game.md b/Projects/Shell-Game.md
new file mode 100644
index 00000000..0ceadb23
--- /dev/null
+++ b/Projects/Shell-Game.md
@@ -0,0 +1,53 @@
+# Shell Game
+
+**Tier:** 3-Advanced
+
+A Shell game is a classic gambling game that dates back to ancient Greece.
+Playing it requires three shells, a pea, hand dexterity by the operator, and
+keen observation skills on the part of the player. It's also a classic con
+game since its easy for the operator to swindle the player. Thank goodness
+the latter isn't our intent with this app.
+
+This Shell game is intended to provide a graphical interface to the classical
+shell game and to provide the player with an honest game to play. Our game
+draws three shells on the canvas along with the pea, moves the pea under one,
+of the shells, and shuffles the shells for a specific interval of time. The
+user must then click on the shell she thinks the pea is hidden under. The user
+is allowed to continue guessing until the pea is located.
+
+## User Stories
+
+- [ ] User can see the canvas with three shells and the pea.
+- [ ] User can click the shell the pea is to be hidden under.
+- [ ] User can see the pea move under the shell thats been clicked.
+- [ ] User can click on a 'Shuffle' button to start an animated shuffling of
+the shells for 5 seconds.
+- [ ] User can click on the shell she believes the pea is hidden under when
+the animation stops.
+- [ ] User can see the shell that has been clicked rise to reveal if the pea
+is hidden under it.
+- [ ] User can continue clicking shells until the pea is found.
+- [ ] User can see a congratulations message when the pea is located
+- [ ] User can start a new game by clicking a shell the pea is to be hidden
+under (step #2 above). The steps above are then repeated.
+
+## Bonus features
+
+- [ ] User can see a score panel containing the number of wins and the
+number of games played.
+- [ ] User can see the number of games played increase when the pea is hidden
+under a shell
+- [ ] User can see the number of wins incremented when the pea is found on
+the first guess.
+- [ ] User can see the shell hiding the pea to animate (color, size, or
+some other effect) when it is clicked (a correct guess).
+
+## Useful links and resources
+
+- [Shell Game (Wikipedia)](https://en.wikipedia.org/wiki/Shell_game)
+- [Javascript HTML DOM Animation](https://www.w3schools.com/js/js_htmldom_animate.asp)
+- [p5js Animation Library](https://p5js.org/)
+
+## Example projects
+
+[Shell Game](https://codepen.io/RedCactus/pen/dwEjXy)
diff --git a/README.md b/README.md
index d0741de0..837b73bd 100644
--- a/README.md
+++ b/README.md
@@ -86,6 +86,7 @@ required to complete them.
| [🌟Fast Food Simulator](./Projects/FastFood-App.md) | Fast Food Restaurant Simulator | 3-Advanced |
| [GitHub Timeline](./Projects/GitHub-Timeline-App.md) | Generate a timeline of a users GitHub Repos | 3-Advanced |
| [Kudos Slackbot](./Projects/Kudos-Slackbot.md) | Give recognition to a deserving peer | 3-Advanced |
+| [🌟Shell Game](./Projects/Shell-Game.md) | Animated shell game | 3-Advanced |
| [Slack Archiver](./Projects/Slack-Archiver.md) | Archive Slack Messages | 3-Advanced |
| [Spell-It App](./Projects/SpellIt-App.md) | A twist on the classic Speak N Spell game | 3-Advanced |
| [Survey App](./Projects/Survey-App.md) | Define, conduct, and view a survey | 3-Advanced |