https://github.com/riteshkumarshukla/gstinsight
The objective of this project is to develop a web application that allows users to verify the GSTIN number of a business entity. The application should use the GST API provided by the GST department to retrieve the relevant information about the GSTIN number.
https://github.com/riteshkumarshukla/gstinsight
chakraui express-js gst nodejs reactjs taxpayers-info
Last synced: about 1 month ago
JSON representation
The objective of this project is to develop a web application that allows users to verify the GSTIN number of a business entity. The application should use the GST API provided by the GST department to retrieve the relevant information about the GSTIN number.
- Host: GitHub
- URL: https://github.com/riteshkumarshukla/gstinsight
- Owner: RiteshKumarShukla
- Created: 2023-08-29T08:37:47.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-09-08T12:44:00.000Z (over 1 year ago)
- Last Synced: 2025-02-13T14:53:08.988Z (3 months ago)
- Topics: chakraui, express-js, gst, nodejs, reactjs, taxpayers-info
- Language: JavaScript
- Homepage: https://gstin-taxpayer.netlify.app/
- Size: 3.89 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GSTINsight
The objective of this project is to develop a web application that allows users to verify the GSTIN number of a business entity. The application should use the GST API provided by the GST department to retrieve the relevant information about the GSTIN number.
## Table of Contents
- [Introduction](#gstdex)
- [Technologies](#technologies)
- [Key Features](#key-features)
- [Screenshots](#screenshots)
- [Getting Started](#getting-started)
- [Deployment](#deployment)
- [Sources](#sources)
## Technologies
GSTINsight is built with the following technologies:
- **Node.js**: A JavaScript runtime environment for building server-side applications.
- **Express**: A fast, minimalist web framework for Node.js, which provides essential features for building robust web applications.
- **React**: A popular JavaScript library for building user interfaces.
- **Chakra UI**: A simple, modular, and accessible component library for building React applications.
## Key Features
- **GSTIN Verification**: Input a GSTIN, and the application will verify its authenticity and retrieve associated information from the MasterGST API.
- **User-Friendly Interface**: A clean and intuitive user interface that allows users to easily enter and verify GSTINs.
- **Real-Time Data Display**: Display of real-time information about the business entity associated with the provided GSTIN.
- **Error Handling**: Graceful handling of errors and validation of input data.
- **Loading Spinner**: A loading spinner indicates when data is being fetched from the API.
- **Responsive Design**: The application is designed to work seamlessly on both desktop and mobile devices.
- **Theme Customization**: The application is designed to work seamlessly on both light mode and dark mode.
## Screenshots
## Getting Started
To run GSTINsight locally, follow these steps:
1. Clone the repository:
```shell
git clone https://github.com/RiteshKumarShukla/GSTINsight.git
cd GSTINsight
```
2. Install dependencies for the backend and frontend:
```shell
# Install backend dependencies
cd server
npm install
# Install frontend dependencies
cd client
npm install
```
3. Set up environment variables:
- Create a `.env` file in the backend directory.
- Add your email and other required API credentials to the `.env` file.
4. Start the application:
```shell
# Start the backend server
cd server
npm start
# Start the frontend development server
cd client
npm start
```
5. Access the application at `http://localhost:3000` in your web browser.
## Deployment
GSTINsight can be deployed to various hosting platforms. Here's a general outline of the deployment process:
1. Build the frontend:
```shell
cd client
npm run build
```
2. Deploy the backend and frontend to your chosen hosting platform (e.g., Heroku, Vercel, Netlify, AWS, etc.).
3. Set up environment variables on your hosting platform for email and API credentials.
4. Configure your hosting platform to serve the frontend build and start the backend server.
5. Access your deployed application using the provided URL.