ISCP ID Generator

A web app that lets International State College of the Philippines students generate their school IDs directly in the browser — no manual design tools required.

🔗 Live: iscpid.vercel.app

---

Features

• Google OAuth sign-in via Firebase Authentication
• Generates a printable student ID card in the browser
• Data stored securely in Firestore
• Deployed automatically via GitHub Actions CI/CD

Tech Stack

• Framework: Next.js 13 (App Router)
• Language: TypeScript
• Auth & DB: Firebase (Authentication + Firestore + Storage)
• Styling: Tailwind CSS
• Deployment: Vercel + GitHub Actions

Getting Started

1. Clone the repo

git clone https://github.com/Adrian-stuff/iscp-id-generator.git
cd iscp-id-generator

2. Set up environment variables

cp .env-example .env

Fill in .env with:

• Google OAuth client ID — get it from Google Cloud Console under APIs & Services → Credentials
• Firebase config — get it from your Firebase project settings

3. Install and run

npm install
npm run dev

Open http://localhost:3000 to view the app.

Deployment

The app is deployed to Vercel. GitHub Actions runs on every push to main to lint and build before deploying.

License

MIT