How adhimiw/adhithan-dev_portfolio works
Project type and purpose
• This is a full-stack portfolio website.
• Purpose: serve a React/Vite frontend (with dynamic and static modes), backed by an Express/MongoDB API, featuring real-time updates via WebSockets, data export for static builds, an admin dashboard, visitor analytics, file uploads, and third-party integrations (Cloudinary, email, push notifications, GitHub OAuth).
File structure
• Top-level directories:
• backend/ – Express server, config (db, Cloudinary), middleware, Mongoose models, routes, WebSocket & push services, utility scripts, server.js
• public/ – static assets and JSON data exports for static builds
• src/ – React application: components (3D, admin, UI, visitor tracking), pages (public and admin), contexts, hooks, services (API wrappers), utils
• Deployment scripts and config: Docker (docker-compose.yml), PM2 (ecosystem.config.js), Netlify (netlify.toml), Vercel (vercel.json), Render (render.yaml, build-for-render.sh), GitHub Actions (.github/workflows/deploy.yml)
• Build & utility scripts: data export/import (backend/scripts), start-dev.sh, deploy-*.sh, check-*.js, sampleData seeds.
README insights
• Architecture summary: dynamic mode (MongoDB ➔ Express API ➔ React via REST + Socket.IO) and static mode (MongoDB ➔ JSON export ➔ static React).
• Tech stack: React-TypeScript, Vite, Tailwind CSS, shadcn/ui, Three.js, Framer Motion; Node.js, Express, MongoDB, Socket.IO; tooling (Bun, Biome, ESLint, GitHub Actions).