A modern full-stack E-Commerce Web Application designed to provide a seamless online shopping experience. The application includes product browsing, user authentication, shopping cart management, checkout, order processing, and a structured backend with database integration.
The project was developed as a full-stack application with a clear separation between the frontend, backend, database layer, and supporting services.
๐ GitHub Repository: https://github.com/umeshkumar-git/e-commerce-app
This project demonstrates the development of a complete e-commerce platform from frontend UI to backend APIs and database management.
The application focuses on:
- Modern and responsive user interface
- Product discovery and browsing
- User authentication
- Shopping cart functionality
- Checkout and order management
- Backend API development
- Database persistence
- Structured application architecture
- Secure environment configuration
- User registration and authentication
- User login/logout
- Browse available products
- View product details
- Add products to cart
- Update product quantities
- Remove products from cart
- Checkout workflow
- Order creation
- Order management
- Product listing
- Product details
- Product categorization
- Product data stored in the database
- Dynamic product retrieval through backend services
- Add products to cart
- Increase/decrease quantity
- Remove products
- Calculate cart totals
- Persistent cart-related data
- Create orders during checkout
- Store customer/order information
- Maintain order records
- Retrieve order information from the database
- User authentication
- Protected application functionality
- Environment-based configuration
- Secure handling of sensitive credentials
โโโโโโโโโโโโโโโโโโโโโโโโ
โ Client โ
โ Frontend โ
โโโโโโโโโโโโฌโโโโโโโโโโโโ
โ
โ API Requests
โผ
โโโโโโโโโโโโโโโโโโโโโโโโ
โ Backend โ
โ Server / API Layer โ
โโโโโโโโโโโโฌโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโ
โ Database Layer โ
โ Prisma โ
โโโโโโโโโโโโฌโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโ
โ Database โ
โโโโโโโโโโโโโโโโโโโโโโโโ
- React
- TypeScript
- Modern CSS / UI styling
- Responsive design
- Component-based architecture
- Node.js
- API-based backend architecture
- Server-side business logic
- REST/API communication
- PostgreSQL
- Prisma ORM
- Git
- GitHub
- npm
- Environment variables
- TypeScript
e-commerce-app/
โ
โโโ backend/
โ โโโ Backend application and API logic
โ
โโโ frontend/
โ โโโ Frontend application
โ
โโโ lib/
โ โโโ Shared libraries and utilities
โ
โโโ prisma/
โ โโโ Database schema and Prisma configuration
โ
โโโ docs/
โ โโโ Project documentation
โ
โโโ prisma.config.ts
โโโ .gitignore
โโโ README.md
The user accesses the e-commerce frontend and can browse the available products.
Products are retrieved from the backend and displayed through the frontend interface.
Users can create an account or log in to access account-related functionality.
Users can add products to their shopping cart and modify quantities before checkout.
The selected products and required order information are submitted to the backend.
The backend processes the request and stores the order information in the database.
Prisma handles communication between the application and the PostgreSQL database.
The project uses Prisma ORM as the database access layer.
Prisma provides:
- Type-safe database queries
- Database schema management
- Structured data models
- Easier database migrations
- Strong integration with TypeScript
The Prisma-related configuration is maintained inside the project's prisma directory and root configuration.
Make sure you have installed:
- Node.js
- npm
- PostgreSQL database
- Git
git clone https://github.com/umeshkumar-git/e-commerce-app.git
cd e-commerce-appInstall dependencies for the frontend and backend:
cd frontend
npm installThen:
cd ../backend
npm installIf your project uses dependencies from the root directory, install them there as well:
cd ..
npm installCreate the required .env files according to your local configuration.
Example:
DATABASE_URL="your_database_connection_string"
NEXTAUTH_URL="http://localhost:3000"
NEXTAUTH_SECRET="your_secret_key"If payment functionality is configured:
RAZORPAY_KEY_ID="your_razorpay_key"
RAZORPAY_KEY_SECRET="your_razorpay_secret"Never commit
.envfiles or secret keys to GitHub.
After configuring the database connection:
npx prisma generateRun the required database migration:
npx prisma migrate devYou can inspect the database using:
npx prisma studioStart the backend:
cd backend
npm run devStart the frontend in another terminal:
cd frontend
npm run devThen open the local development URL shown by the frontend development server.
The backend is responsible for handling application requests such as:
User Authentication
โ
โผ
Product Requests
โ
โผ
Cart Operations
โ
โผ
Checkout
โ
โผ
Order Processing
โ
โผ
Database
This separation keeps the frontend focused on presentation and user interaction while the backend handles business logic and data operations.
The main goals of this project were to:
- Build a complete full-stack e-commerce application
- Understand frontend/backend integration
- Implement database-driven functionality
- Work with Prisma ORM
- Build reusable frontend components
- Develop backend APIs
- Handle authentication and application security
- Understand real-world e-commerce workflows
- Practice production-oriented project structure
Through this project, I gained practical experience in:
- Full-stack web application development
- React and TypeScript
- Backend API development
- Database design
- Prisma ORM
- PostgreSQL
- Authentication
- API integration
- Environment configuration
- Git and GitHub
- Debugging full-stack applications
- Structuring scalable web applications
Possible improvements for future versions include:
- Advanced product search
- Product filtering and sorting
- Wishlist functionality
- Product reviews and ratings
- Order tracking
- Admin dashboard
- Inventory management
- Image optimization
- Email notifications
- Payment gateway improvements
- Automated testing
- CI/CD pipeline
- Production deployment
- Performance optimization
Add screenshots of the application here.
docs/
โโโ home.png
โโโ products.png
โโโ product-details.png
โโโ cart.png
โโโ checkout.png
โโโ orders.png
Example:



Computer Science & Engineering Student Full-Stack Developer
GitHub: https://github.com/umeshkumar-git
This project is intended for educational and portfolio purposes.
If you found this project useful or interesting, consider giving the repository a โญ on GitHub.
Built with โค๏ธ by Umesh Kumar Shah