Skip to content

Commit 9233d39

Browse files
authored
WEB-102 Update README to include npm ci instructions (#115)
2 parents 6ca718b + 1a87c93 commit 9233d39

2 files changed

Lines changed: 40 additions & 22 deletions

File tree

README.md

Lines changed: 37 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,58 +1,75 @@
11
# SGA Website Internal CMS Application
2-
This is SGA's internal application tool to allow for SGA's Webmaster Team to easily manage and update SGA's website. We are developing new features for administrators to modify the application without the need for changes in the core code structure, allowing for quick content management and visual edits throughout the website.
32

4-
# Technologies
5-
## Frontend:
3+
This is SGA's internal application tool to allow for SGA's Webmaster Team to easily manage and update SGA's website. We are developing new features for administrators to modify the application without the need for changes in the core code structure, allowing for quick content management and visual edits throughout the website.
4+
5+
## Technologies
6+
7+
### Frontend
8+
69
- React.js: The core UI framework for developing reusable components for faster development, reducing redundancy, and building the infrastructure of the website.
710
- React Puck: The drag-and-drop editor logic for Webmasters to utilize for quick and visual content management and layout changes.
811
- TailwindCSS: Utility-first CSS that allows direct styling within individual lines through classes, insuring for consistent design through the website.
912
- Next.js: Allows for component rendering and server-side capabilities to improve performance and SEO while enabling seamless full-stack development
1013

11-
## Backend:
14+
### Backend
15+
1216
- Prisma: The ORM that simplifies database queries, migrations, and interaction through the database.
1317
- PostgreSQL: Primary relational database that allows for efficient data storage.
1418
- Next.js: Handles the API routing on the server side with robust backend endpoints directly in the framework.
1519

16-
## Deployment
20+
### Deployment
21+
1722
- Vercel: Host deployment for the website with optimized performance.
1823

19-
## Authentication
24+
### Authentication
25+
2026
- Supabase: Backend service that provides authentication services for different user permissions.
2127

22-
# Setup
23-
## Cloning and Running the Project
28+
## Setup
29+
30+
### Cloning and Running the Project
31+
2432
We *highly* recommend the use of VSCode for this project. Please download the VSCode and clone the GitHub repository either using the command below or cloning the repo with the web URL.
25-
```
33+
34+
```sh
2635
git clone git@github.com:SGAOperations/website-development.git
2736
```
2837

2938
After opening the project, open the terminal and navigate to the project directory:
30-
```
39+
40+
```sh
3141
cd website-development
3242
```
3343

3444
Once you are in the directory, install all package dependencies by running:
35-
```
36-
npm install
45+
46+
```sh
47+
npm ci
3748
```
3849

50+
If you are cloning this project for the first time, please refer to /docs/SUPABASE_SETUP.md for instructions on how to set up Supabase.
51+
3952
Afterwards, you should be able to run the application using:
40-
```
53+
54+
```sh
4155
npm run dev
4256
```
4357

44-
The applications expects a local database and will return an error without it. Look at DATABASE_SETUP.md for Prisma/Postgres setup instructions.
58+
## Features for implementation
4559

46-
# Features for implementation
4760
- Visual Drag-and-Drop Editor
4861
- Database and Versioning
4962
- Version Control or Pages
5063
- Authentication & Login Services
5164
- Navigation Within the Editor Interface
5265
- TBD - Future Features
5366

54-
# Team Contributors
55-
### Digital Innovation Website Team Leads:
56-
Caitlin Lee, Willem Lenig
57-
### Digital Innovation Website Software Engineers:
58-
Shlok Patel, Grace Silge, Matthew Shi
67+
## Team Contributors
68+
69+
### Digital Innovation Team Leads
70+
71+
Caitlin Lee, Willem Lenig
72+
73+
### Digital Innovation Software Engineers
74+
75+
Rai Makaraju, Shlok Patel, Grace Silge, Matthew Shi

docs/SUPABASE_SETUP.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ npx supabase start
2020

2121
If Docker is running, Supabase will begin creating a local instance of the necessary services. On success, it should output something like:
2222

23-
```
23+
```bash
2424
╭─────────────────────────────────────────────────╮
2525
│ 🌐 APIs │
2626
├─────────────┬───────────────────────────────────┤
@@ -61,11 +61,12 @@ SUPABASE_SERVICE_ROLE_KEY="sb_secret_XXXXXXXXX"
6161

6262
```bash
6363
npx prisma migrate dev
64-
```
64+
```
6565

6666
This will apply the Prisma schema to your local database. You can also use `npx prisma studio` to view and manage your database records in a nice UI.
6767

6868
## Resetting the database
69+
6970
If you want to reset your database (e.g. to clear all data), you can run:
7071

7172
```bash

0 commit comments

Comments
 (0)