react-repos 1.0.1 → 1.0.2

package/package.json

@@ -1,17 +1,14 @@
+
 {
   "name": "react-repos",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "You can’t burn ashes twice, but you can always start a new fire.",
   "license": "MIT",
   "author": "madhav",
   "type": "commonjs",
   "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "dependencies": {
-    "react-repos": "^0.0.0-stage",
-    "sasa-greet-madhav": "^1.0.0",
-    "suhanaa": "^1.0.0"
-  }
+  "files": [
+    "index.js",
+    "repos/"
+  ]
 }

package/repos/task-common/README.md

@@ -0,0 +1,63 @@
+# MERN Common Starter
+
+A reusable building-block repository for MERN dashboards and CRUD applications. It uses a Create React App-compatible frontend, Bootstrap-only styling, an Express MVC API, Mongoose validation, MongoDB seed data, and separate components for common interface patterns.
+
+## Included building blocks
+
+### Backend
+
+- Database connection module
+- Generic Mongoose model
+- REST controller and routes for list, detail, create, update, patch, and delete
+- Search and dropdown query filters
+- JSON 404 and error middleware
+- Seed script and sample data
+- Unit-tested query builder
+
+### Frontend
+
+- Application shell, fixed sidebar, and top bar
+- Page header and action slot
+- Metric cards, badges, progress bars, and entity cards
+- Configurable filter bar and data table
+- Shared pagination hook and component
+- Generic modal and confirmation dialog
+- Reusable loading, error, and empty states
+- Controlled create/edit form
+- Axios service layer, CRUD hook, and React context
+- Example dashboard, CRUD list, and profile routes
+
+## Start MongoDB
+
+MongoDB must be available at `mongodb://127.0.0.1:27017`. Copy `backend/.env.example` to `backend/.env` if you want to change the database or API port.
+
+## Run the backend
+
+```bash
+cd backend
+npm install
+npm run seed
+npm start
+```
+
+The API runs at `http://localhost:5002`.
+
+## Run the frontend
+
+```bash
+cd frontend
+npm install
+npm start
+```
+
+The frontend runs at `http://localhost:3000`. Copy `frontend/.env.example` to `frontend/.env` to override the API URL.
+
+## Adapt it to a new project
+
+1. Rename `Item` in the backend model, controller, and route modules.
+2. Replace the schema fields and validation rules in `backend/models/Item.js`.
+3. Rename `itemService`, `useItems`, and `ItemContext` in the frontend.
+4. Update `ItemForm`, `ItemCard`, and the page column/filter configuration.
+5. Change branding, colors, navigation, and user text in `frontend/src/config/theme.js` and the layout components.
+
+Common components are intentionally domain-neutral, so they can be retained when the entity-specific modules are replaced.

package/repos/task-common/backend/.env.example

@@ -0,0 +1,3 @@
+# Copy to .env and adjust values for the local project.
+PORT=5002
+MONGODB_URI=mongodb://127.0.0.1:27017/mern_common

package/repos/task-common/backend/app.js

@@ -0,0 +1,16 @@
+// Assembles Express middleware, health check, routes, and error handling.
+const express = require('express');
+const cors = require('cors');
+const itemRoutes = require('./routes/itemRoutes');
+const notFound = require('./middleware/notFound');
+const errorHandler = require('./middleware/errorHandler');
+
+const app = express();
+app.use(cors());
+app.use(express.json());
+app.get('/api/health', (req, res) => res.json({ status: 'ok' }));
+app.use('/api/items', itemRoutes);
+app.use(notFound);
+app.use(errorHandler);
+
+module.exports = app;

package/repos/task-common/backend/config/db.js

@@ -0,0 +1,11 @@
+// Creates the shared Mongoose connection used by the API and scripts.
+const mongoose = require('mongoose');
+
+const connectDatabase = async () => {
+  const uri = process.env.MONGODB_URI || 'mongodb://127.0.0.1:27017/mern_common';
+  const connection = await mongoose.connect(uri);
+  console.log(`MongoDB connected: ${connection.connection.host}`);
+  return connection;
+};
+
+module.exports = connectDatabase;

package/repos/task-common/backend/controllers/itemController.js

@@ -0,0 +1,51 @@
+// Implements reusable list, detail, create, update, and delete controller actions.
+const mongoose = require('mongoose');
+const Item = require('../models/Item');
+const { buildQuery } = require('../utils/buildQuery');
+
+const findItem = async (id) => {
+  if (!mongoose.isValidObjectId(id)) return null;
+  return Item.findById(id);
+};
+
+const listItems = async (req, res, next) => {
+  try {
+    const items = await Item.find(buildQuery(req.query)).sort({ createdAt: -1 });
+    res.json(items);
+  } catch (error) { next(error); }
+};
+
+const getItem = async (req, res, next) => {
+  try {
+    const item = await findItem(req.params.id);
+    if (!item) return res.status(404).json({ message: 'Item not found' });
+    return res.json(item);
+  } catch (error) { return next(error); }
+};
+
+const createItem = async (req, res, next) => {
+  try {
+    const item = await Item.create(req.body);
+    res.status(201).json(item);
+  } catch (error) { next(error); }
+};
+
+const updateItem = async (req, res, next) => {
+  try {
+    if (!mongoose.isValidObjectId(req.params.id)) return res.status(400).json({ message: 'Invalid item id' });
+    const item = await Item.findByIdAndUpdate(req.params.id, req.body, { new: true, runValidators: true });
+    if (!item) return res.status(404).json({ message: 'Item not found' });
+    return res.json(item);
+  } catch (error) { return next(error); }
+};
+
+const deleteItem = async (req, res, next) => {
+  try {
+    if (!mongoose.isValidObjectId(req.params.id)) return res.status(400).json({ message: 'Invalid item id' });
+    const item = await Item.findByIdAndDelete(req.params.id);
+    if (!item) return res.status(404).json({ message: 'Item not found' });
+    return res.json({ message: 'Item deleted' });
+  } catch (error) { return next(error); }
+};
+
+module.exports = { listItems, getItem, createItem, updateItem, deleteItem };

package/repos/task-common/backend/data/items.json

@@ -0,0 +1,5 @@
+[
+  { "name": "Plan the interface", "description": "Create the initial screen structure", "priority": "High", "status": "In Progress", "dueDate": "2026-11-01", "progress": 60 },
+  { "name": "Connect the API", "description": "Wire the client to the REST service", "priority": "Medium", "status": "To Do", "dueDate": "2026-11-05", "progress": 20 },
+  { "name": "Review the release", "description": "Perform the final quality review", "priority": "Low", "status": "Review", "dueDate": "2026-11-08", "progress": 85 }
+]

package/repos/task-common/backend/middleware/errorHandler.js

@@ -0,0 +1,7 @@
+// Converts application and Mongoose errors into consistent JSON responses.
+const errorHandler = (error, req, res, next) => {
+  if (res.headersSent) return next(error);
+  const status = error.name === 'ValidationError' ? 400 : error.status || 500;
+  return res.status(status).json({ message: error.message || 'Internal server error' });
+};
+module.exports = errorHandler;

package/repos/task-common/backend/middleware/notFound.js

@@ -0,0 +1,3 @@
+// Produces a JSON 404 response for routes that are not defined.
+const notFound = (req, res) => res.status(404).json({ message: `Route not found: ${req.method} ${req.originalUrl}` });
+module.exports = notFound;

package/repos/task-common/backend/models/Item.js

@@ -0,0 +1,16 @@
+// Defines a reusable work-item model that can be renamed for a domain entity.
+const mongoose = require('mongoose');
+
+const itemSchema = new mongoose.Schema(
+  {
+    name: { type: String, required: true, trim: true },
+    description: { type: String, default: '', trim: true },
+    priority: { type: String, enum: ['High', 'Medium', 'Low'], default: 'Medium' },
+    status: { type: String, enum: ['To Do', 'In Progress', 'Review', 'Done'], default: 'To Do' },
+    dueDate: { type: Date, required: true },
+    progress: { type: Number, min: 0, max: 100, default: 0 },
+  },
+  { timestamps: true }
+);
+
+module.exports = mongoose.model('Item', itemSchema);

package/repos/task-common/backend/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "mern-common-backend",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Reusable Express and MongoDB CRUD API boilerplate",
+  "main": "server.js",
+  "scripts": {
+    "start": "node server.js",
+    "dev": "nodemon server.js",
+    "seed": "node scripts/seed.js",
+    "test": "node --test"
+  },
+  "dependencies": {
+    "cors": "^2.8.6",
+    "dotenv": "^18.0.0",
+    "express": "^5.1.0",
+    "mongoose": "^9.0.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.10"
+  }
+}