👕 What To Wear (WTWR) — Backend API

A RESTful backend for the What To Wear app — a full-stack project from TripleTen's Software Engineering Program.
Built with Express, MongoDB, and JWT authentication.

---

🚀 Overview

This backend powers the WTWR weather app, allowing users to:

• Register and log in with secure JWT-based authentication
• Manage clothing items (create, like/unlike, delete)
• Retrieve and update user profiles
• Connect with the front-end client for full-stack functionality

---

🌐 Live Deployment

• Frontend: https://www.weatherapp.jumpingcrab.com
• Backend API: https://api.weatherapp.jumpingcrab.com

All routes below can be tested at https://api.weatherapp.jumpingcrab.com using Postman or your browser.

---

🧰 Tech Stack

• Node.js / Express
• MongoDB / Mongoose
• JWT Authentication
• Celebrate / Joi (input validation)
• Winston (logging)
• dotenv for environment config

---

⚙️ Installation & Setup

1️⃣ Clone and Install Dependencies

git clone https://github.com/bbeare22/se_project_express
cd se_project_express
npm install

2️⃣ Environment Variables

Create a .env file in the project root with the following keys:

PORT=3001
MONGO_URL=mongodb://127.0.0.1:27017/wtwr_db
JWT_SECRET=your-production-secret
JWT_SECRET_DEV=your-dev-secret
NODE_ENV=development

For production (your deployment), the environment may look like:

PORT=3001
MONGO_URL=<your-mongo-connection-string>
JWT_SECRET=supersecretkey
NODE_ENV=production
CLIENT_URL=https://www.weatherapp.jumpingcrab.com

3️⃣ Start the Server

Development mode (with nodemon):

npm run dev

Production mode:

npm start

The server will run locally at http://localhost:3001
or in production at https://api.weatherapp.jumpingcrab.com.

---

📦 Project Structure

se_project_express/
├── app.js                 # Main entry
├── controllers/           # Request handlers
│   ├── clothingItems.js
│   └── users.js
├── errors/                # Custom error classes
├── middlewares/           # Auth, validation, logging, etc.
├── models/                # Mongoose schemas (User, ClothingItem)
├── routes/                # Express routers
│   ├── clothingItems.js
│   └── index.js
├── utils/                 # Config and helper utilities
└── .env.example           # Environment variable reference

---

🔑 API Endpoints

👤 Users

Method	Endpoint	Description
GET	/users/me	Get current user profile
PATCH	/users/me	Update user info

👕 Clothing Items

Method	Endpoint	Description
POST	/items	Create new clothing item (auth required)
DELETE	/items/:itemId	Delete clothing item (auth required)
PUT	/items/:itemId/likes	Like item (auth required)
DELETE	/items/:itemId/likes	Unlike item (auth required)

---

🔒 Security & Validation

• JWT-based authentication
• Input validation with Celebrate/Joi
• Password hashing with bcryptjs
• CORS middleware configured to allow https://www.weatherapp.jumpingcrab.com
• Helmet for HTTP header security
• Centralized error handling
• Custom error classes for clear API responses

---

🧾 Example .env

PORT=3001
MONGO_URL=mongodb://127.0.0.1:27017/wtwr_db
JWT_SECRET=supersecretkey
CLIENT_URL=https://www.weatherapp.jumpingcrab.com
NODE_ENV=production

---

🧠 Developer Scripts

Command	Description
npm run dev	Start with nodemon for development
npm start	Start production server
npm run lint	Run ESLint checks

---

🧩 Dependencies

Production: bcryptjs, celebrate, cors, dotenv, express, express-winston, jsonwebtoken, mongoose, validator, winston

Dev: eslint, eslint-config-airbnb-base, eslint-config-prettier, eslint-plugin-import, nodemon, prettier

---

🧪 API Testing

Use Postman or cURL to test endpoints:
Example:

curl -X GET https://api.weatherapp.jumpingcrab.com/users/me -H "Authorization: Bearer <token>"

---

✨ WTWR Backend — keeping your wardrobe weather-ready.