Skip to content

Commit 6df0f12

Browse files
committed
UI is enhanced
1 parent 2ce5c1a commit 6df0f12

22 files changed

Lines changed: 528 additions & 164 deletions

File tree

README.md

Lines changed: 143 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,158 @@
1-
This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
21

3-
## Getting Started
2+
# **AcademiaDrive - University Notes Sharing Platform**
43

5-
First, run the development server:
4+
Welcome to **AcademiaDrive**, a platform designed to solve the problem of accessing and sharing study materials within your university or college. If your university doesn't provide easy access to study materials, or if you just want to make your own notes available to others, **AcademiaDrive** is the solution.
5+
6+
The platform takes your existing Google Drive-based file-sharing system and upgrades it to a **GitHub Pages**-hosted website, making it more user-friendly and easily accessible for everyone in your college or university.
7+
8+
### **How It Works:**
9+
10+
**AcademiaDrive** allows you to create, upload, and share your notes in a simple, clean way. All you need to do is create a folder structure inside the **public** folder, upload your notes, and the website automatically reflects the changes.
11+
12+
---
13+
14+
## **How to Use and Contribute:**
15+
16+
### 1. **Fork the Repository:**
17+
18+
* Visit the [AcademiaDrive GitHub Repository](https://github.com/yourusername/academiadrive).
19+
* Click the **Fork** button on the top-right to create a copy of this repository under your GitHub account.
20+
21+
### 2. **Clone the Repository:**
22+
23+
After forking, clone the repository to your local machine:
24+
25+
```bash
26+
git clone https://github.com/yourusername/academiadrive.git
27+
cd academiadrive
28+
```
29+
30+
### 3. **Upload Your Notes:**
31+
32+
* Inside the **public** folder, create folders to organize your notes however you like. It can be by course, subject, or even by specific topics.
33+
* You can add any kind of study material, such as PDF files, notes, slides, videos, and more.
34+
* Example structure:
35+
36+
```
37+
public/academiadrive/
38+
├── Math101/
39+
│ └── Math_Notes.pdf
40+
├── CS201/
41+
│ └── CS_Slides.pdf
42+
├── Physics/
43+
│ └── Physics_Notes.pdf
44+
├── Videos/
45+
│ └── Lecture1.mp4
46+
```
47+
48+
### 4. **Commit Your Changes:**
49+
50+
Once you've added your notes, commit and push your changes:
651

752
```bash
8-
npm run dev
9-
# or
10-
yarn dev
11-
# or
12-
pnpm dev
13-
# or
14-
bun dev
53+
git add .
54+
git commit -m "Added Math101 and CS201 notes"
55+
git push origin main
1556
```
1657

17-
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
58+
### 5. **Create a Pull Request (PR):**
59+
60+
* After pushing your changes, go to the **Pull Requests** tab and create a **New Pull Request** to merge your changes into the main repository. This will make your notes available to everyone in your university or college.
61+
62+
### 6. **Accessing Notes:**
63+
64+
* After your changes are merged, the newly added notes will be accessible through the website hosted on GitHub Pages.
65+
* Students can browse the folders by course, subject, or topic and download the materials they need.
66+
67+
---
68+
69+
70+
## **Folder Structure Explanation:**
71+
72+
You have full flexibility to organize your notes however you like! Here are a few examples of how to structure your folders within `public/academiadrive/`:
73+
74+
### 1. **By Course:**
75+
76+
Organize your notes by course name or code:
77+
78+
```plaintext
79+
public/academiadrive/
80+
├── CS101/
81+
├── MATH201/
82+
├── BIO102/
83+
```
84+
85+
### 2. **By Subject:**
86+
87+
Organize your notes by subject area, such as Math, Computer Science, or Physics:
88+
89+
```plaintext
90+
public/academiadrive/
91+
├── Math/
92+
├── ComputerScience/
93+
├── Physics/
94+
```
95+
96+
### 3. **By Topic:**
97+
98+
Organize your notes by specific topics or modules within the course:
99+
100+
```plaintext
101+
public/academiadrive/
102+
├── LinearAlgebra/
103+
├── DataStructures/
104+
├── MachineLearning/
105+
```
106+
107+
---
108+
109+
110+
111+
## **Technologies Used:**
112+
113+
* **GitHub**: To host the repository and manage contributions.
114+
* **GitHub Pages**: To host the website and provide easy access to notes.
115+
* **HTML/CSS**: Basic styling and structure for the web interface.
116+
* **JavaScript (Optional)**: If you choose to add interactive features, you can use JavaScript.
117+
118+
---
119+
120+
## **How to Access Notes:**
121+
122+
1. Go to the **AcademiaDrive** website hosted on GitHub Pages.
123+
2. Browse through the folders organized by course, subject, or topic.
124+
3. Click to view or download the study materials (PDFs, slides, videos, etc.) that you need.
125+
126+
---
127+
128+
## **Contributing Guidelines:**
129+
130+
1. **Be Respectful**: This is a community-driven platform. Please contribute in a way that helps others and maintains a collaborative environment.
131+
2. **Stay Organized**: Keep your folder structure clean and easy to navigate so others can quickly find the materials they need.
132+
3. **Naming Conventions**: Please follow a simple naming convention for your notes so that they are easily identifiable.
133+
134+
---
135+
136+
## **Need Help?**
137+
138+
If you run into any issues or have questions, feel free to open an issue on the GitHub repository or reach out to the project maintainers.
139+
140+
---
18141

19-
You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
142+
### **Join the Community:**
20143

21-
This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
144+
By contributing your notes to **AcademiaDrive**, you're helping make academic resources more accessible to everyone in your university or college. Let’s work together to ensure that every student has access to the materials they need to succeed.
22145

23-
## Learn More
146+
---
24147

25-
To learn more about Next.js, take a look at the following resources:
148+
### **License:**
26149

27-
- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
28-
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
150+
This project is licensed under the [MIT License](LICENSE).
29151

30-
You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
152+
---
31153

32-
## Deploy on Vercel
154+
### **Conclusion:**
33155

34-
The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
156+
The goal of **AcademiaDrive** is to make it easy for students within your university or college to access and share study materials. Instead of relying on external services like Google Drive, **AcademiaDrive** takes it a step further by providing a **dedicated website** that anyone in your university can access and contribute to.
35157

36-
Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
158+
This solution is scalable and can be easily adapted to other universities or colleges facing similar challenges.

package-lock.json

Lines changed: 10 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,19 +9,20 @@
99
"lint": "next lint"
1010
},
1111
"dependencies": {
12+
"lucide-react": "^0.525.0",
13+
"next": "15.3.5",
1214
"react": "^19.0.0",
13-
"react-dom": "^19.0.0",
14-
"next": "15.3.5"
15+
"react-dom": "^19.0.0"
1516
},
1617
"devDependencies": {
17-
"typescript": "^5",
18+
"@eslint/eslintrc": "^3",
19+
"@tailwindcss/postcss": "^4",
1820
"@types/node": "^20",
1921
"@types/react": "^19",
2022
"@types/react-dom": "^19",
21-
"@tailwindcss/postcss": "^4",
22-
"tailwindcss": "^4",
2323
"eslint": "^9",
2424
"eslint-config-next": "15.3.5",
25-
"@eslint/eslintrc": "^3"
25+
"tailwindcss": "^4",
26+
"typescript": "^5"
2627
}
2728
}

public/academiadrive/Year_2015_Syllabus/CS101_ComputerScience_Fundamentals/Lecture1_Introduction.pdf

Whitespace-only changes.

public/academiadrive/Year_2015_Syllabus/MATH201_LinearAlgebra/LectureNotes.pdf

Whitespace-only changes.

public/academiadrive/Year_2015_Syllabus/PHY102_Waves_and_Oscillations/LectureNotes.pdf

Whitespace-only changes.

public/academiadrive/Year_2019_Syllabus/BIO202_Biochemistry/LectureNotes.pdf

Whitespace-only changes.

public/academiadrive/Year_2019_Syllabus/CS102_Programming_in_C/Lecture1_Basics.pdf

Whitespace-only changes.

public/academiadrive/Year_2019_Syllabus/MATH301_Advanced_Calculus/Lecture1_Theory.pdf

Whitespace-only changes.

public/academiadrive/Year_2023_Syllabus/CHEM301_Inorganic_Chemistry/Exam_Papers.pdf

Whitespace-only changes.

0 commit comments

Comments
 (0)