Quickz

A simple web application to distribute, answer and manage quizzes

Introduction

Quickz is a simple application that allows admins to distribute and manage quizzes to members in their organization and users to answer the assigned quizzes.

Manual

For admin

• Click “I am an admin” to register an admin account first.
• Login to your account.
• Create your question bank in /admin/questions
• Manage your organization’s members in /admin/members
• Create a quiz and see its details in /admin (Note : If you select “All guests” when creating the quiz, it means that everyone, with or without an account, will be above to answer this quiz. However, only your members’ answer sheets will be saved.)

For user

• Click “I am a user” to register a user account first. (Note : You need your organization’s secret key to register, which would be randomly generated when your admin registers his/her account and can be obtained from him/her.)
• Login to your account.
• Answer quizzes, view archived answer sheets in /user.

Deploy on your own

• Create a vercel project on vercel dashboard.

• Replace POSTGRES_URL in .env with your own Postgres URL.

• Run

  npm i -g vercel
  vercel link
  vercel env pull

• Run

  pnpm install
  pnpm dev

Acknowledgements

• Website is hosted by vercel.
• Database is provided by neon.
• UI components are from shadcn/ui.
• Icons are from Lucide.
• Localization is supported by i18next