https://github.com/samit22/aus-citizenship-test
Simple quiz app for Australian citizenship
https://github.com/samit22/aus-citizenship-test
Last synced: 6 months ago
JSON representation
Simple quiz app for Australian citizenship
- Host: GitHub
- URL: https://github.com/samit22/aus-citizenship-test
- Owner: samit22
- License: mit
- Created: 2025-03-16T01:32:16.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-16T09:24:30.000Z (11 months ago)
- Last Synced: 2025-08-16T11:28:59.591Z (11 months ago)
- Language: TypeScript
- Size: 120 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🇦🇺 Australian Citizenship Quiz App
This is a simple quiz app designed to help prepare for the Australian citizenship test. It features a Go backend and a Next.js frontend, with a total of 350 questions covering key topics from the [official test](https://immi.homeaffairs.gov.au/citizenship-subsite/files/our-common-bond-testable.pdf).
## 🛠️ Tech Stack
- Backend: Go (Golang)
- Frontend: Next.js (React) with Material UI
## Run with Docker
Make sure docker is installed and running
```
make up
```
## 🚀 Getting Started
Clone the rep
```
git clone git@github.com:samit22/aus-citizenship-test.git
```
### 1️⃣ Backend Setup
Ensure you have Go installed.
```
cd backend
make run
```
### 2️⃣ Frontend Setup
Ensure you have Node 20+ installed. Then, run:
```
cd frontend
make run
```
### 3️⃣ Accessing the App
Once both backend and frontend are running, open:
http://localhost:3000
## 📝 Customization
You can update the questions in the questions.json file inside backend
Modify the UI
## 🎯 Why This App?
This app was built specifically for my wife as she prepares for the Australian citizenship test. If you're also studying, I hope this helps you too! 🇦🇺💙