Skip to content

Latest commit

Β 

History

187 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ InkBoard

COP 4331 – Large Project | University of Central Florida

Live Demo SwaggerHub Flutter MERN


πŸ‘₯ Team Members

Name Role
[Name 1] Frontend / React
[Name 2] Backend / Express API
[Name 3] Mobile / Flutter
[Name 4] Database / MongoDB
[Name 5] DevOps / Deployment

πŸ“– Project Description

[Describe your project here β€” what it does, who it's for, and why you built it.]


πŸ› οΈ Tech Stack

Frontend

  • React (TypeScript) β€” component-based UI
  • Bootstrap / Tailwind CSS β€” responsive styling
  • AJAX β€” asynchronous API communication

Backend

  • Node.js + Express β€” RESTful API server
  • JWT (JSON Web Tokens) β€” authentication & security
  • SendGrid / NodeMailer β€” email verification & password reset

Database

  • MongoDB (remote) β€” document-based NoSQL database

Mobile

  • Flutter β€” cross-platform iOS & Android app

DevOps & Hosting

  • [Heroku / Digital Ocean / AWS / Azure / GoDaddy] β€” remote hosting
  • Domain Name: https://your-domain.com
  • GitHub β€” source control & collaboration

✨ Features

  • πŸ” User Authentication β€” JWT-secured login/logout
  • πŸ“§ Email Verification β€” account confirmation on signup
  • πŸ”‘ Password Recovery β€” forgot-password email flow
  • πŸ“± Mobile App β€” cross-platform Flutter application
  • 🌐 Web App β€” fully AJAX-enabled React frontend
  • πŸ” Live Search β€” single-keypress round-trip server queries
  • πŸ“„ Pagination β€” efficient data browsing
  • πŸ—‘οΈ Delete Confirmation β€” single alert-box confirmation UX

πŸ—οΈ Architecture & Documentation

Document Link
πŸ“Š Gantt Chart View
πŸ—‚οΈ ERD (Entity Relationship Diagram) View
πŸ“‹ Use Case Diagram View
πŸ”„ Activity / Sequence Diagram View
πŸ“ Class Diagram (Mobile) View
πŸ–ΌοΈ Prototypes / Wireframes (Figma) View
πŸ”† Lighthouse Report View
πŸ“‘ SwaggerHub API Docs View
βœ… Unit & Integration Test Results View

πŸ“‘ API

Full API documentation is available on SwaggerHub:
πŸ”— SwaggerHub API Docs

The API uses JSON for all client-server communication.

Sample Endpoints

GET    /api/[resource]        - Get all items
POST   /api/[resource]        - Create a new item
GET    /api/[resource]/:id    - Get item by ID
PUT    /api/[resource]/:id    - Update item by ID
DELETE /api/[resource]/:id    - Delete item by ID

πŸš€ Getting Started

Prerequisites

  • Node.js v16+
  • npm or yarn
  • MongoDB Atlas account (or local instance for dev)
  • Flutter SDK (for mobile)

Installation

# Clone the repository
git clone https://github.com/your-org/your-repo.git
cd your-repo

Backend

cd server
npm install
cp .env.example .env   # Fill in your environment variables
npm start

Frontend

cd client
npm install
npm start

Mobile (Flutter)

cd mobile
flutter pub get
flutter run

Environment Variables

Create a .env file in /server with the following:

MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
SENDGRID_API_KEY=your_sendgrid_key
PORT=5000

πŸ§ͺ Testing

# Run unit & integration tests
cd server
npm test

Test results and coverage reports are available in /docs/test-results.


πŸ“ Project Structure

β”œβ”€β”€ client/          # React (TypeScript) frontend
β”œβ”€β”€ server/          # Node.js + Express API
β”œβ”€β”€ mobile/          # Flutter mobile app
β”œβ”€β”€ docs/            # Diagrams, wireframes, test results
β”‚   β”œβ”€β”€ gantt/
β”‚   β”œβ”€β”€ erd/
β”‚   β”œβ”€β”€ use-case/
β”‚   β”œβ”€β”€ wireframes/
β”‚   └── test-results/
└── README.md

πŸ“ Reflections

βœ… What Went Well

  • [e.g., Team communication via Discord]
  • [e.g., API design and SwaggerHub integration]
  • [e.g., Flutter cross-platform development]

⚠️ What Could Be Improved

  • [e.g., Earlier start on deployment setup]
  • [e.g., More thorough unit test coverage from the start]

πŸ“† Course Info

Field Detail
Course COP 4331 – Processes of Object-Oriented Software
University University of Central Florida
Semester Spring 2022
Presentation 15 minutes β€” [Your Scheduled Date]

πŸ“œ License

This project was created for educational purposes as part of UCF COP 4331.

About

Description goes here.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages