TEYZIX CORE Internship Portal is a modern, professional, and fully responsive internship management platform designed to bridge the gap between talented students and industry opportunities. Built with cutting-edge full-stack technologies, it offers seamless UX, secure data handling, and a scalable architecture ready for production.
| 🎯 Core Functionality | 🎨 UI/UX Experience | 🔒 System Features |
|---|---|---|
| 📋 Browse Internship Listings | 🌙 Full Dark Mode Support | 🗄️ MongoDB Integration |
| 📝 Online Application Forms | 🎞️ Smooth Framer Motion Animations | 🔗 RESTful API Architecture |
| 🖥️ Admin Dashboard Panel | 📱 100% Mobile Responsive | 🛡️ Secure Data Storage |
| 👥 Applicant Management | ⚡ Fast Page Transitions | ⚙️ Modular MVC Backend |
| 📊 Application Tracking | 🎯 Clean & Minimal UI | 🔄 Dynamic Data Seeding |
| Technology | Purpose | Version |
|---|---|---|
 |
UI Library & Component Architecture | ^18.x |
 |
Utility-First Styling Framework | ^3.x |
 |
Animation & Page Transitions | ^10.x |
 |
HTTP Client for API Requests | ^1.x |
 |
Lightning Fast Build Tool | ^5.x |
| Technology | Purpose | Version |
|---|---|---|
 |
JavaScript Runtime Environment | ^20.x |
 |
Web Application Framework | ^4.x |
 |
NoSQL Database | ^7.x |
 |
MongoDB ODM & Schema Modeling | ^8.x |
This project currently uses a local/in-memory MongoDB setup for development and demonstration purposes.
Due to limited cloud database resources, a production MongoDB Atlas deployment has not been configured yet.
The application architecture is fully prepared for MongoDB Atlas or any production database integration in the future.
🔗 https://teyzix-core-internship-portal-fs2.vercel.app/
Note: The Internships page currently shows a network error because internship data is fetched through backend API calls. This deployment currently includes only the frontend UI. Once the backend server is live, the Internships page will function properly.
Make sure you have the following installed before starting:
1️⃣ Clone the Repository
git clone https://github.com/YasirAwan4831/teyzix-core-portal.git
cd teyzix-core-portal2️⃣ Setup Environment Variables
cp .env.example .env
# Edit .env with your MongoDB URI and PORT3️⃣ Install Server Dependencies
cd server
npm install4️⃣ Seed the Database
npm run seed5️⃣ Start the Backend Server
npm run dev6️⃣ Install Client Dependencies
cd ../client
npm install7️⃣ Launch the Frontend
npm run dev🎉 The app will be live at
http://localhost:5173
teyzix-core-portal/
│
├── 📁 client/ # React Frontend
│ ├── 📁 dist/ # Production Build Output
│ │ ├── 📁 assets/
│ │ │ ├── 🎨 index-B50JeYTQ.css
│ │ │ └── ⚡ index-WIs0T0k4.js
│ │ ├── 🖼️ favicon.svg
│ │ └── 🌐 index.html
│ │
│ ├── 📁 public/ # Static Assets
│ │ ├── 🖼️ favicon.svg
│ │ └── 🎯 icons.svg
│ │
│ ├── 📁 src/ # Source Code
│ │ ├── 📁 assets/ # Images & Media
│ │ │ ├── 🖼️ hero.png
│ │ │ └── ⚛️ react.svg
│ │ │
│ │ ├── 📁 components/ # Reusable Components
│ │ │ ├── 🧩 Navbar.jsx
│ │ │ └── 🦶 Footer.jsx
│ │ │
│ │ ├── 📁 context/ # React Context API
│ │ │ └── 🌙 ThemeContext.jsx
│ │ │
│ │ ├── 📁 pages/ # Application Pages
│ │ │ ├── 🏠 Home.jsx
│ │ │ ├── 💼 Internships.jsx
│ │ │ ├── 📝 Apply.jsx
│ │ │ ├── 📬 Contact.jsx
│ │ │ └── 🔧 Admin.jsx
│ │ │
│ │ ├── 🎨 App.css
│ │ ├── ⚛️ App.jsx
│ │ └── 🚀 main.jsx
│ │
│ └── ⚙️ vite.config.js
│
├── 📁 server/ # Node.js Backend
│ ├── 📁 config/
│ │ └── 🗄️ db.js # MongoDB Connection
│ │
│ ├── 📁 controllers/ # Business Logic
│ │ ├── 📋 internshipController.js
│ │ └── 📝 applicationController.js
│ │
│ ├── 📁 data/
│ │ └── 💾 internships.js # Seed Data
│ │
│ ├── 📁 middleware/
│ │ └── 🛡️ errorMiddleware.js # Error Handling
│ │
│ ├── 📁 models/ # Mongoose Schemas
│ │ ├── 🏢 Internship.js
│ │ └── 👤 Application.js
│ │
│ ├── 📁 routes/ # API Routes
│ │ ├── 🔗 internshipRoutes.js
│ │ └── 🔗 applicationRoutes.js
│ │
│ ├── 🌱 seeder.js # Database Seeder
│ └── 🚀 server.js # Entry Point
│
├── 📄 .env.example
├── 📄 CONTRIBUTING.md
├── 📄 SETUP.md
├── 📄 LICENSE
└── 📖 README.md
| Method | Endpoint | Description | Status |
|---|---|---|---|
 |
/api/internships |
Fetch All Internships | ✅ Active |
|
/api/internships/:id |
Get Single Internship | ✅ Active |
 |
/api/internships |
Create New Internship | ✅ Active |
 |
/api/internships/:id |
Remove Internship | ✅ Active |
| Method | Endpoint | Description | Status |
|---|---|---|---|
|
/api/applications |
Submit Application | ✅ Active |
|
/api/applications |
Get All Applications | ✅ Active |
|
/api/applications/:id |
Delete Application | ✅ Active |
Phase 1 ✅ — Core System Phase 2 🚧 — Enhancement Phase 3 🔭 — Scale & Deploy
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[✅] Internship Listings [🔧] JWT Authentication [🌐] Cloud Deployment (Vercel)
[✅] Online Applications [🔧] Email Notifications [☁️] AWS / Railway Backend
[✅] Admin Dashboard [🔧] Resume Upload (PDF) [📈] Analytics Dashboard
[✅] MongoDB Integration [🔧] Search & Filtering [🔐] OAuth 2.0 Login
[✅] REST API Backend [🔧] Multi-User Role System [📱 ] PWA Support
[✅] Responsive Design [🔧] Application Status Tracker [🌍] Internationalization
Contributions are what make the open source community amazing! Any contributions you make are greatly appreciated.
- 🍴 Fork the Project
- 🌿 Create your Feature Branch —
git checkout -b feature/AmazingFeature - 💾 Commit your Changes —
git commit -m 'Add some AmazingFeature' - 📤 Push to the Branch —
git push origin feature/AmazingFeature - 🔁 Open a Pull Request
Please read CONTRIBUTING.md for details on our code of conduct.
Distributed under the MIT License.
See
LICENSEfor more information.
If this project helped you or you found it interesting, please consider giving it a star!
Develop ❤️ By Muhammad Yasir — TEYZIX CORE Internship Program