https://github.com/jstarfilms/student-super-app_gemini
A comprehensive student portal featuring announcements, resource sharing, and feedback management, built with Next.js, TypeScript, and Prisma.
https://github.com/jstarfilms/student-super-app_gemini
Last synced: about 2 months ago
JSON representation
A comprehensive student portal featuring announcements, resource sharing, and feedback management, built with Next.js, TypeScript, and Prisma.
- Host: GitHub
- URL: https://github.com/jstarfilms/student-super-app_gemini
- Owner: JStaRFilms
- Created: 2025-07-02T21:52:08.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-02T21:57:32.000Z (11 months ago)
- Last Synced: 2025-07-02T22:34:18.173Z (11 months ago)
- Language: TypeScript
- Size: 0 Bytes
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Student Super App
A comprehensive student portal built with modern web technologies to enhance the academic experience. This platform provides a centralized hub for students to access announcements, share resources, and manage their academic journey.
## ✨ Features
- 📢 **Announcements**: Stay updated with the latest news and important notices
- 📚 **Resource Sharing**: Access and share study materials and resources
- 💬 **Feedback System**: Provide and receive feedback on courses and faculty
- 👤 **User Profiles**: Personalized dashboard and profile management
- 🔐 **Secure Authentication**: Built with NextAuth.js for secure user authentication
- 🎨 **Modern UI**: Clean and responsive design with Tailwind CSS
## 🚀 Tech Stack
- **Frontend**: Next.js 13+ with TypeScript
- **Styling**: Tailwind CSS
- **Database**: PostgreSQL with Prisma ORM
- **Authentication**: NextAuth.js
- **API Routes**: tRPC for end-to-end typesafe APIs
- **Form Handling**: React Hook Form with Zod validation
## 🛠️ Getting Started
### Prerequisites
- Node.js 16.8 or later
- npm or yarn
- PostgreSQL database
### Installation
1. Clone the repository:
```bash
git clone https://github.com/JStaRFilms/student-super-app_gemini.git
cd student-super-app
```
2. Install dependencies:
```bash
npm install
# or
yarn
```
3. Set up environment variables:
Copy `.env.example` to `.env` and update the values:
```bash
cp .env.example .env
```
4. Set up the database:
```bash
npx prisma db push
```
5. Run the development server:
```bash
npm run dev
# or
yarn dev
```
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
## 📦 Project Structure
```
student-super-app/
├── prisma/ # Database schema and migrations
├── public/ # Static files
├── src/
│ ├── app/ # App router pages
│ ├── components/ # Reusable UI components
│ ├── server/ # Server-side code
│ │ ├── api/ # API routes
│ │ └── db/ # Database client
│ └── styles/ # Global styles
├── .env.example # Environment variables example
└── package.json # Project dependencies and scripts
```
## 🤝 Contributing
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## 📄 License
Distributed under the MIT License. See `LICENSE` for more information.
## 📧 Contact
Your Name - [@your_twitter](https://twitter.com/your_twitter) - your.email@example.com
Project Link: [https://github.com/JStaRFilms/student-super-app_gemini](https://github.com/JStaRFilms/student-super-app_gemini)
## 🙏 Acknowledgments
- [T3 Stack](https://create.t3.gg/) for the amazing starter template
- All contributors who have helped shape this project
## 🚀 Deployment
This application can be easily deployed to various platforms:
- [Vercel](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme)
- [Netlify](https://www.netlify.com/)
- [Docker](https://www.docker.com/)
For detailed deployment instructions, please refer to the [T3 Stack deployment guide](https://create.t3.gg/en/deployment).