Skip to content

Sakura Study is a quiz-based Japanese language learning app inspired by Duolingo and based on the textbook Genki: An Integrated Course in Elementary Japanese (3rd edition).

Notifications You must be signed in to change notification settings

kt946/japanese-quiz-mern-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sakura Study

SakuraStudyBanner

Description

Sakura Study is a MERN (MongoDB, Express.js, React, Node.js) language learning app designed to help people study Japanese using a gamified approach, similar to Duolingo. The app offers exercises for users to practice material from the popular Japanese textbook, Genki: An Integrated Course in Elementary Japanese (3rd edition), including hiragana, katakana, kanji, vocabulary, and phrases. It also features leaderboards for users to compete with each other and track their progress, along with a dark mode feature. It was created to assist students of all ages and levels in learning Japanese in a fun and engaging way through self-study. 頑張って!(Good luck!)

⭐ Note: The website may require some time for the server to spin up.

Table of Contents

Installation

To install Sakura Study on, follow these steps:

  1. Clone the repository or download as a ZIP file.
  2. Navigate to the rood directory and open a command-line interface (CLI) in that location.
  3. In the CLI at the root directory, install the dependencies in both the client and server directories by running npm install.
  4. Create a .env file in the server directory and add the following environment variables:
MONGODB_URI
JWT_SECRET

The MONGODB_URI is the connection string to your MongoDB database. The JWT_SECRET can be any string of your choice.

  1. In the CLI at the root directory, run npm run dev to start the development server and launch the app in your browser.
  2. Navigate to http://localhost:5173/ to view the project.

Features

Sakura Study provides a range of features to help users study Japanese including:

  • Practice exercises for Hiragana, Katakana, Kanji, vocabulary, and phrases
  • Track progress and compete with other users through leaderboards
  • Secure user authentication and authorization using JWT
  • User data management with MongoDB
  • Client-server communication through GraphQL
  • Sleek UI, dark mode, and responsive design using Tailwind CSS
  • Efficient state management with Redux
  • Keyboard shortcuts and sound effects

Future features include:

  • More practice exercises
  • Achievements
  • Profile settings

Usage

To use Sakura Study, follow these steps:

  1. Sign up and create an account.
  2. Navigate to the Lessons page to practice vocabulary and phrases from your lessons.
  3. Go to the Characters page to study and practice hiragana, katakana, and kanji from your lessons.
  4. Check the Leaderboards page to track of your progress and see other users' progress.
  5. Access the Profile page to view your statistics and progress. As of now, it only tracks your total xp.
  6. Toggle dark mode on or off depending on your preferences.
  7. When you are done with your session, log out to protect your account.
  8. To start a quiz, click on a 'Start Quiz' button in a section and begin answering questions. Select the correct choice for each question and click on the 'Check' button to check your answer. You can also skip questions by clicking the skip button. Correct answers will increase your progress while incorrect answers or skipped questions will decrease your progress. Once the progress bar is filled, the quiz will end and you will be taken to the results page.

Screenshots

homepage-screenshot

This is the home page, where users start their journey.


characters-screenshot

At the Characters page, users can begin learning hiragana, katakana, and kanji.


leaderboards-screenshot

Climb the ranks and compete with fellow learners on our leaderboards.


profile-screenshot

View your progress on your profile page.


quiz-screenshot

Test your knowledge and reinforce your learning with interactive quizzes.


darkmode-screenshot

Switch to Dark Mode for a comfortable, nighttime-friendly experience.


tablet-smartphone-screenshot

Mobile responsive design ensures a seamless experience on desktops, tablets, and smartphones.

Technologies Used

Sakura Study is built using a variety of technologies including:

Contributing

Contributions to Sakura Study are welcome and encouraged! If you'd like to contribute to this project, please fork the repository and submit a pull request.

Credits

Links

License

This project is licensed under the MIT License.