Skip to content

assafavital/parabole

Folders and files

NameName
Last commit message
Last commit date

Latest commit

4fa6a95 ยท Nov 10, 2024

History

51 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

๐ŸŽฏ Parabole - The Daily Quadratic Guessing Game!

Welcome to Parabole, a fun and challenging daily web game where players must deduce the coefficients of a quadratic equation! Every day, a new random quadratic function of the form y = a x 2 + b x + c is generated, and it's up to you to guess the coefficients a , b , and c with as few guesses as possible!

๐ŸŒŸ How to Play

  1. Each day, you're presented with a graph of a quadratic function.
  2. Make your first guess for the coefficients a , b , and c .
  3. Receive feedback on how close you are to the correct coefficients.
  4. Continue guessing until you find the exact values!

๐Ÿงฎ Quadratic Functions - A Quick Refresher

A quadratic function is a polynomial of degree 2, represented as:

y = a x 2 + b x + c

  • a controls the parabola's openness and direction.
  • b shifts the parabola horizontally.
  • c moves the parabola up or down vertically.

The challenge is to decode how these parameters shape the curve and find the right coefficients!

๐Ÿ•น๏ธ Features

  • Daily Challenge: A new quadratic function every day!
  • Graph Visualization: Visual feedback with a plotted graph to aid your guesses.
  • Hint System: Get hints based on the difference between your guess and the actual values.
  • Result Tracking: Keep track of your wins and share them with friends!

๐Ÿš€ Get Started

To play the game, head over to the Parabole Game Site and start guessing!

Running Locally

To run the game locally on your machine:

  1. Clone the repository:
git clone https://github.com/assafavital/parabole.git
  1. Install the dependencies:
npm install
  1. Start the development server:
npm start
  1. Visit http://localhost:1234 in your browser to play!

๐Ÿ› ๏ธ Built With

  • Frontend: HTML, CSS, JavaScript
  • Backend: Node.js
  • Graphing Library: functionplot by D3
  • Hosting: GitHub Pages / No-IP

๐Ÿ“ˆ Roadmap

  • Add more difficulty levels (e.g. larger coefficient ranges)
  • Include more sophisticated hints (e.g. derivative/integral)
  • Weekly challenges with special quadratic equations

๐Ÿ™Œ Contributions

Contributions, issues, and feature requests are welcome! Feel free to check out the issues page.