CMS Project

Full-stack Content Management System for college website
Built with modern technologies and industry best practices

---

📋 Overview

A complete, production-ready CMS with authentication, CRUD operations, search, and admin dashboard. Built as a learning project following industry standards.

---

✨ Features

• ✅ User authentication (JWT + bcrypt)
• ✅ Post management (CRUD operations)
• ✅ Image uploads
• ✅ Search and filtering
• ✅ Admin dashboard with statistics
• ✅ Public blog interface
• ✅ Soft delete pattern
• ✅ 80+ tests passing
• ✅ Responsive design

---

🚀 Quick Start

Prerequisites

• Node.js 18+
• PostgreSQL database
• npm

Installation

# Install dependencies
npm install
cd frontend && npm install && cd ..

# Configure environment
cp .env.example .env
# Edit .env with your database URL

# Set up database
npx prisma migrate dev

# Start backend (Terminal 1)
npm run dev  # http://localhost:5001

# Start frontend (Terminal 2)
cd frontend && npm run dev  # http://localhost:3000

Login

• Email: admin@example.com
• Password: admin123

---

📁 Project Structure

cms-project/
├── src/                    # Backend (Node.js + Express)
├── frontend/src/           # Frontend (React + Vite)
├── docs/                   # Documentation
├── .claude/                # AI assistant configuration
└── prisma/                 # Database schema

See PROJECT_STRUCTURE.md for detailed structure.

---

🛠️ Tech Stack

Backend

• Node.js 18 + Express.js
• PostgreSQL (Neon) + Prisma ORM
• JWT + bcrypt authentication

Frontend

• React 18 + Vite 5
• Tailwind CSS 3
• React Router 6

---

📚 Documentation

Essential Files

• MASTER_PROMPT.md - God-level Claude CLI prompt (START HERE)
• START.md - Simple start guide
• CLAUDE.md - Auto-loaded project context

Claude Elite Stack (THE BIBLE)

• claude-elite-stack/ - Complete elite development guide
  • 11 comprehensive guides
  • Agent-driven architecture
  • 60 production-ready prompts
  • Credit optimization strategies
  • GetShitDone workflow

Technical Documentation

• Backend Guide - Complete backend docs
• API Integration - Frontend-backend connection
• Project Structure - File organization
• Contributing - How to contribute
• Changelog - Version history
• GitHub MCP Setup - Automated GitHub commits

---

🧪 Testing

# Backend tests
npm test

# Frontend tests
cd frontend && npm test

Coverage: 85% | Tests: 80+

---

📊 API Endpoints

Public

• GET /public/posts - List published posts
• GET /public/posts/:id - Get single post

Admin (Auth Required)

• POST /auth/login - Login
• POST /posts - Create post
• GET /posts - List all posts
• PUT /posts/:id - Update post
• DELETE /posts/:id - Delete post

---

🎓 Learning Project

This project covers:

• Full-stack development
• Clean architecture
• RESTful API design
• React patterns
• Authentication & authorization
• Database design
• Testing strategies

---

🤝 Contributing

See CONTRIBUTING.md for guidelines.

---

👤 Author

Student Developer - Learning through AI-assisted workflow

---

Last updated: April 1, 2026