https://github.com/ahmedreda958/had-exams

https://github.com/ahmedreda958/had-exams

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/ahmedreda958/had-exams
• Owner: AhmedReda958
• Created: 2024-09-11T19:42:22.000Z (4 months ago)
• Default Branch: master
• Last Pushed: 2024-09-12T20:17:55.000Z (4 months ago)
• Last Synced: 2024-09-13T11:05:26.000Z (4 months ago)
• Language: TypeScript
• Homepage: https://had-exams.vercel.app
• Size: 379 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Frontend Interview Task: Exam Management System

This is a **Next.js** project designed to implement an **Exam Management System** where users can create, edit, and manage exams with multiple-choice questions.

## Project Overview

The application allows users to:

- Create and edit exams with multiple-choice questions.

- Designate correct answers and ensure validation before submission.

- View a list of stored exams and update them as needed.

The project was bootstrapped using [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).

## Getting Started

To run the development server:

```bash

npm run dev

# or

yarn dev

# or

pnpm dev

```

Once the server is running, open [http://localhost:5050](http://localhost:5050) in your browser to access the application.

### Editing the Project

To start editing, modify the `pages/index.tsx` file for the main page or any other page. Changes will be automatically reflected in the browser.

## Features

- **Next.js (Page Router)**: The project uses the traditional `pages` directory for routing.

- **TypeScript**: Ensures type safety across the application.

- **Local Storage**: Exam data is persisted using local storage.

- **ShadCN Toaster**: Implemented for notifications when creating or editing exams.

## Prerequisites

Before running the project, make sure you have:

- Node.js installed

- `npm`, `yarn`, or `pnpm` installed for dependency management.

## How to Use

1. **Create an Exam**: Navigate to the exam editor and add questions, answers, and mark the correct answer.

2. **View and Edit Exams**: Go to the exam list to view all exams and update them as needed.

3. **Deploy**: Easily deploy the application using platforms like Vercel.

## Learn More

For more information about Next.js, check out the following resources:

- [Next.js Documentation](https://nextjs.org/docs)

- [Next.js GitHub Repository](https://github.com/vercel/next.js/)

## Deployment

To deploy the project, you can use [Vercel](https://vercel.com/), which is optimized for Next.js applications.

Refer to the [Next.js deployment documentation](https://nextjs.org/docs/deployment) for detailed instructions.

---

This version of the README is more focused on the features and functionality of your **Exam Management System** project.