Skip to content
zis3cPublic

About

Official STEM USAS web portal for Universiti Sultan Azlan Shah. A bilingual landing page for club programs, student-built projects, and membership registration. Built with React, Vite, TypeScript, and Tailwind CSS.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

STEM USAS Landing Page

STEM USAS Web Preview

Welcome to the official web repository for Persatuan Sains, Teknologi & Multimedia (STEM) Universiti Sultan Azlan Shah (USAS).

This project is a high-performance, single-page application (SPA) designed to showcase the club's initiatives and student-built projects, and to handle new member registrations.

Core Features

  • Bilingual Support: Fully localized in English (EN) and Bahasa Malaysia (MS).
  • Glassmorphic UI: High-end modern styling with glowing gradients and backdrop blurs.
  • Smooth Scrolling: Powered by Lenis for buttery-smooth scrolling physics.
  • Responsive Design: Fully optimized for mobile, tablet, and desktop viewing.
  • Easter Eggs: Secret interactive elements hidden for the tech-savvy.

Tech Stack

Frontend Architecture

Getting Started

Detailed Setup Guide: For an in-depth walkthrough of setting up the environment, please see our comprehensive Installation Guide.

Follow these quick steps to get a local copy of the STEM USAS landing page up and running.

Prerequisites

  • Node.js (v22.0.0 or higher recommended)
  • npm, yarn, or pnpm
  • Git

Installation

  1. Clone the repository

    git clone https://github.com/zis3c/STEM-Web.git
    cd STEM-Web
  2. Install dependencies

    npm install
  3. Run the Application Launch the development server with Hot Module Replacement (HMR).

    npm run dev
  4. Run the quality checks Run lint, security lint, TypeScript checks, unit tests, and the production build.

    npm run test:strict

Project Structure

STEM-Web/
├── .github/                 # CI, CodeQL, Dependabot and deploy workflows
├── public/                  # Static assets, SEO files and security headers
│   ├── _headers
│   ├── _redirects
│   ├── robots.txt
│   └── sitemap.xml
├── src/                     # Main application
│   ├── features/
│   │   └── landing/         # Landing page sections
│   ├── shared/
│   │   ├── components/      # Shared UI and brand icons
│   │   ├── i18n/            # English and Bahasa Malaysia translations
│   │   ├── lib/             # Helpers, scroll and console banner
│   │   └── theme/           # Light and dark theme provider
│   ├── styles/              # Global Tailwind styles
│   ├── App.tsx              # Main entry layout component
│   └── main.tsx             # ReactDOM mount and routing fallback
├── index.html               # HTML shell and pre-paint theme script
├── vite.config.ts           # Vite and Vitest configuration
└── wrangler.toml            # Cloudflare Pages configuration

Contributing

We welcome contributions from the community! Please read our Contributing Guidelines to get started. By participating in this project, you agree to abide by our Code of Conduct.

Security

If you discover any security-related issues, please refer to our Security Policy for information on how to responsibly disclose vulnerabilities.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

About

Official STEM USAS web portal for Universiti Sultan Azlan Shah. A bilingual landing page for club programs, student-built projects, and membership registration. Built with React, Vite, TypeScript, and Tailwind CSS.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages