https://github.com/gitcommitshow/quiz-app-boilerplate

A quiz web app, instant subjective evaluation with ai, incremental hints, works offline, sync remote
https://github.com/gitcommitshow/quiz-app-boilerplate

boilerplate indexdb offline-first quiz

Last synced: about 1 month ago
JSON representation

A quiz web app, instant subjective evaluation with ai, incremental hints, works offline, sync remote

• Host: GitHub
• URL: https://github.com/gitcommitshow/quiz-app-boilerplate
• Owner: gitcommitshow
• Created: 2024-09-11T16:53:07.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-01-16T12:41:35.000Z (over 1 year ago)
• Last Synced: 2025-03-08T17:51:46.088Z (about 1 year ago)
• Topics: boilerplate, indexdb, offline-first, quiz
• Language: JavaScript
• Homepage: https://gitcommitshow.github.io/quiz-app-boilerplate/
• Size: 737 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 15
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# A quiz app boilerplate

This is a simple quiz app boilerplate

![Screenshot](./feature_banner.png)

## Features

- Objective questions

- Subjective questions

- Offline-first: Loads questions from a JSON file

- Display questions and answers

    - Supports diagrams via mermaid

    - Supports markdown text

- Provide hints for incorrect answers

- Save user answers to a JSON file

- Evaluate subjective questions using AI

- Incremental hints using AI

## Installation

1. Clone the repository

2. Run `npm install`

3. Run `npm run dev` to start both the frontend (Vite) and API server together

## Deployment

1. Set the environment variables (check out `sample.env` for the list of these vars)

2. Run `npm run build` to build the app

4. The `dist` folder will be created with the app ready to be deployed

4. Deploy the `dist` folder to your favorite hosting service