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.
- 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.
Frontend Architecture
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.
- Node.js (v22.0.0 or higher recommended)
- npm, yarn, or pnpm
- Git
-
Clone the repository
git clone https://github.com/zis3c/STEM-Web.git cd STEM-Web -
Install dependencies
npm install
-
Run the Application Launch the development server with Hot Module Replacement (HMR).
npm run dev
-
Run the quality checks Run lint, security lint, TypeScript checks, unit tests, and the production build.
npm run test:strict
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
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.
If you discover any security-related issues, please refer to our Security Policy for information on how to responsibly disclose vulnerabilities.
This project is licensed under the MIT License. See the LICENSE file for more details.
