Skip to content

Commit 049087e

Browse files
authored
Cleanup (#38)
* Restructure project and enhance overall clarity - Updated and cleaned up README.md for improved structure and clarity - Updated project for MySQL database compatibility - Fixed various TypeScript errors in index.tsx - Removed unused dependencies and redundant comments - Cleaned up migrations and codebase * Added utilities and improved layout - Introduced clsx utility for conditional class names - Updated layout for better user experience * Fixed paths and Docker-related configurations - Updated path to Docker file - Added .DS_Store to .gitignore * General improvements - Updated project title for consistency - Updated build process for better performance
1 parent 88d9201 commit 049087e

81 files changed

Lines changed: 4318 additions & 3532 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/workflows/build.yml

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,11 +13,13 @@ jobs:
1313
- uses: actions/checkout@v4
1414
- name: Build the Docker image
1515
run: |
16+
cd webapp && \
1617
docker compose build \
1718
--no-cache \
18-
--build-arg NODE_ENV="development" \
19-
--build-arg DATABASE_URL=${{ secrets.DATABASE_URL }} \
20-
--build-arg POSTGRES_PASSWORD=${{ secrets.POSTGRES_PASSWORD }} \
19+
--build-arg NODE_ENV="production" \
20+
--build-arg DB_URL=${{ secrets.DB_URL }} \
21+
--build-arg DB_PASS=${{ secrets.DB_PASS }} \
22+
--build-arg DB_NAME=${{ secrets.DB_NAME }} \
2123
--build-arg NEXTAUTH_URL=${{ secrets.NEXTAUTH_URL }} \
2224
--build-arg NEXTAUTH_SECRET=${{ secrets.NEXTAUTH_SECRET }} \
2325
--build-arg GOOGLE_CLIENT_ID=${{ secrets.GOOGLE_CLIENT_ID }} \

.gitignore

Lines changed: 4 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,4 @@
1-
# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
2-
3-
# dependencies
4-
/node_modules
5-
/.pnp
6-
.pnp.js
7-
8-
# testing
9-
/coverage
10-
11-
# database
12-
/prisma/db.sqlite
13-
/prisma/db.sqlite-journal
14-
15-
# next.js
16-
/.next/
17-
/out/
18-
next-env.d.ts
19-
20-
# production
21-
/build
22-
23-
# misc
24-
.DS_Store
25-
*.pem
26-
27-
# debug
28-
npm-debug.log*
29-
yarn-debug.log*
30-
yarn-error.log*
31-
.pnpm-debug.log*
32-
33-
# local env files
34-
# do not commit any .env files to git, except for the .env.example file. https://create.t3.gg/en/usage/env-variables#using-environment-variables
35-
.env
36-
.env*.local
37-
38-
# vercel
39-
.vercel
40-
41-
# typescript
42-
*.tsbuildinfo
1+
webapp/node_modules
2+
webapp/.next
3+
.github/.DS_Store
4+
.gitignore

README.md

Lines changed: 47 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,65 +1,76 @@
1-
# Swarthmore A11yGator
1+
# Accessible Docs
22

3-
### **Welcome**
4-
Swarthmore A11yGator is an innovative platform aimed at enhancing the accessibility of course materials for Swarthmore College students. This platform ensures an inclusive learning environment by providing remediated and accessible documents, notes, and other course materials to meet the diverse needs of students.
3+
## Welcome
4+
5+
**Accessible Docs** is an innovative platform aimed at enhancing the accessibility of course materials for Swarthmore College students. This platform ensures an inclusive learning environment by providing remediated and accessible documents, notes, and other course materials to meet the diverse needs of students.
6+
7+
## What's in this Repo?
8+
9+
The **Accessible Docs** app is in the [webapp](webapp/) folder.
10+
The scripts folder contains [Python scripts](scripts/) used to prepare the data for the webapp.
11+
12+
## Project Goals
13+
14+
**Accessible Docs** aims to:
15+
16+
- Provide a central hub for students to access accessible course materials.
17+
- Ensure compliance with accessibility standards such as WCAG.
18+
- Continuously improve functionality and user experience based on user feedback.
19+
20+
## Features
521

6-
### **Features**
722
- **Accessible Course Materials:** Access a variety of course documents, all remediated to comply with accessibility standards.
823
- **Light and Dark Mode:** Enjoy a user-friendly interface with customizable viewing preferences.
924
- **Responsive Design:** Seamlessly access materials on any device, from mobile phones to desktops.
1025
- **AI-Powered Search:** Quickly find what you need using advanced AI-driven search functionality. *(Upcoming feature)*
1126
- **Profile Customization:** Highlight and save readings, and personalize your material library. *(Upcoming feature)*
1227

13-
---
14-
15-
### **Tech Stack**
16-
- **Frontend:**
17-
- Next.js for server-side rendering.
18-
- React for dynamic client-side functionality.
19-
- **Backend:**
20-
- tRPC for type-safe API routes without schema duplication.
21-
- Prisma ORM for seamless database interaction.
22-
- **Database:** PostgreSQL for reliable and efficient data storage.
23-
- **Authentication:** NextAuth.js for secure and simple user authentication.
24-
- **Styling:** Tailwind CSS for a clean, responsive, and accessible design.
25-
- **Hosting:** Vercel for continuous integration and deployment.
26-
- **Storage:** AWS S3 for document storage and management.
28+
## For Developers
2729

28-
---
30+
### Quick Start
2931

30-
### **Quick Start**
3132
1. **Clone the Repository**
33+
3234
```bash
33-
git clone https://github.com/Swarthmore/a11y-doc-repo.git
34-
cd a11y-doc-repo
35+
git clone https://github.com/Swarthmore/accessible-docs.git
36+
cd accessible-docs
3537
```
38+
3639
2. **Install Dependencies**
40+
3741
```bash
3842
npm install
3943
```
44+
4045
3. **Set Up Environment Variables**
46+
4147
- Copy the `.env.example` file to `.env` and populate it with the required values.
4248
- Ensure you include your Google OAuth redirect URL in your Google Console dashboard.
49+
4350
4. **Run Database Migration**
51+
4452
```bash
45-
npx prisma migrate resolve --applied 20240816170427_init
46-
```
47-
5. **Run in Docker** (Optional)
48-
Start the app in a Docker container:
49-
```bash
50-
docker compose up -d
53+
npx prisma migrate deploy
5154
```
52-
6. **Start the Development Server**
55+
56+
5. **Start the Development Server**
57+
5358
```bash
5459
npm run dev
5560
```
5661

57-
---
62+
You can also run the project in docker using `docker-compose up`
5863

59-
### **Project Goals**
60-
Swarthmore A11yGator aims to:
61-
- Provide a central hub for students to access accessible course materials.
62-
- Ensure compliance with accessibility standards such as WCAG.
63-
- Continuously improve functionality and user experience based on user feedback.
64+
### Tech Stack
6465

65-
---
66+
- **Frontend:**
67+
- Next.js for server-side rendering.
68+
- React for dynamic client-side functionality.
69+
- **Backend:**
70+
- tRPC for type-safe API routes without schema duplication.
71+
- Prisma ORM for seamless database interaction.
72+
- **Database:** PostgreSQL for reliable and efficient data storage.
73+
- **Authentication:** NextAuth.js for secure and simple user authentication.
74+
- **Styling:** Tailwind CSS for a clean, responsive, and accessible design.
75+
- **Hosting:** Vercel for continuous integration and deployment.
76+
- **Storage:** AWS S3 for document storage and management.

prisma/migrations/20240816170427_init/migration.sql

Lines changed: 0 additions & 66 deletions
This file was deleted.

prisma/migrations/20241113194045_add_role_to_user/migration.sql

Lines changed: 0 additions & 70 deletions
This file was deleted.

0 commit comments

Comments
 (0)