Skip to content

Commit 2bc7315

Browse files
committed
feat: Footer Added, fix: README.md updated with full documentation
1 parent e3e8ec5 commit 2bc7315

4 files changed

Lines changed: 196 additions & 7 deletions

File tree

README.md

Lines changed: 181 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,186 @@
1-
# React + Vite
21

3-
This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
2+
# QR Code Generator
43

5-
Currently, two official plugins are available:
4+
![License](https://img.shields.io/badge/license-MIT-blue.svg)
65

7-
- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) for Fast Refresh
8-
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
6+
> A blazing fast React application powered by [Vite](https://vitejs.dev/) and modern development practices. Perfect for rapid development, prototyping, and deployment.
97
10-
## Expanding the ESLint configuration
8+
---
119

12-
If you are developing a production application, we recommend using TypeScript with type-aware lint rules enabled. Check out the [TS template](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) for information on how to integrate TypeScript and [`typescript-eslint`](https://typescript-eslint.io) in your project.
10+
## 📝 Table of Contents
11+
12+
1. [QR Code Generator](#ar-QRcodegenerator-react)
13+
2. [Overview](#-overview)
14+
3. [Prerequisites](#-prerequisites)
15+
4. [Installation](#-installation)
16+
5. [Running the Application](#-running-the-application)
17+
6. [Project Structure](#-project-structure)
18+
7. [Available Scripts](#-available-scripts)
19+
8. [Deployment](#-deployment)
20+
9. [Technologies Used](#-technologies-used)
21+
10. [Contributing](#-contributing)
22+
11. [License](#-license)
23+
24+
---
25+
26+
## 📖 Overview
27+
28+
This project is a React + Vite-based web application designed to save your url, username and password in your browsers localStorage.
29+
It emphasizes performance, fast refresh, minimal configuration, and ease of use.
30+
31+
**Key Features:**
32+
- Lightning-fast development with Vite
33+
- React with hooks and functional components
34+
35+
---
36+
37+
## ✅ Prerequisites
38+
39+
Ensure you have the following installed:
40+
41+
- [Node.js](https://nodejs.org/) (>= 16.x)
42+
- [npm](https://www.npmjs.com/) or [Yarn](https://yarnpkg.com/)
43+
- Git
44+
45+
Check versions:
46+
47+
```bash
48+
node -v
49+
npm -v
50+
git --version
51+
```
52+
53+
---
54+
55+
## 📦 Installation
56+
57+
Clone the repository and install dependencies:
58+
59+
```bash
60+
git clone https://github.com/Aamir-Rafique/ar-QRcodegenerator-react.git
61+
cd ar-QRcodegenerator-react
62+
npm install
63+
# or
64+
yarn install
65+
66+
# then
67+
npm i react-toastify
68+
npm i react-qr-code
69+
```
70+
71+
---
72+
73+
## 🚀 Running the Application
74+
75+
Start the development server:
76+
77+
```bash
78+
npm run dev
79+
# or
80+
yarn dev
81+
```
82+
83+
Then open [http://localhost:5173](http://localhost:5173) to view it in the browser.
84+
85+
---
86+
87+
## 📁 Project Structure
88+
89+
```
90+
ar-passwizard-react-localStorage/
91+
├── public
92+
│ |── icons/
93+
│ └── images/
94+
├── src/
95+
│ ├── assets/
96+
│ ├── components
97+
|── QRCodeGen.jsx
98+
└── Footer.jsx
99+
│ ├── App.jsx
100+
│ ├── main.jsx
101+
│ └── index.css
102+
├── .gitignore
103+
├── index.html
104+
├── package-lock.json
105+
├── package.json
106+
├── README.md
107+
├── LICENSE
108+
├── vite.config.js
109+
110+
```
111+
112+
---
113+
114+
## ⚙️ Available Scripts
115+
116+
| Script | Description |
117+
|------------------|---------------------------------------|
118+
| `npm run dev` | Runs app in development mode |
119+
120+
---
121+
122+
## 🚢 Deployment
123+
124+
You can deploy this app using:
125+
126+
- **Vercel**
127+
- **Netlify**
128+
- **GitHub Pages**
129+
- Any static host (upload the `dist/` folder after `npm run build`)
130+
131+
**Example (Vercel):**
132+
133+
1. Push your repo to GitHub
134+
2. Link it in your [Vercel dashboard](https://vercel.com/)
135+
3. Set `npm run build` as the build command
136+
4. Set `dist` as the output directory
137+
138+
---
139+
140+
## 🛠 Technologies Used
141+
142+
- [React](https://reactjs.org/)
143+
- [Vite](https://vitejs.dev/)
144+
- [Tailwind CSS](https://tailwindcss.com/) (optional)
145+
- [React-toastify](https://www.npmjs.com/package/react-toastify?activeTab=readme)
146+
- [React-qr-code](https://www.npmjs.com/package/qrcode)
147+
148+
149+
---
150+
151+
## 🤝 Contributing
152+
153+
Contributions are welcome! Here's how to get started:
154+
155+
1. Fork the repository
156+
2. Create a new branch (`git checkout -b feature/your-feature`)
157+
3. Make your changes and commit them
158+
4. Push to your fork (`git push origin feature/your-feature`)
159+
5. Open a pull request
160+
161+
Please follow the [Conventional Commits](https://www.conventionalcommits.org/) standard for commits.
162+
163+
---
164+
165+
## 📄 License
166+
167+
This project is licensed under the **MIT License**.
168+
See the [LICENSE](./LICENSE) file for details.
169+
170+
---
171+
172+
## 📷 Screenshots (Optional)
173+
174+
<p align="center">
175+
<img src="./public/images/SSQRCodeApp.png" alt="App Screenshot" width="700" />
176+
</p>
177+
178+
---
179+
180+
## 🙋‍♂️ Questions?
181+
182+
If you have any questions or suggestions, feel free to open an issue or reach out on [Gmail](https://mail.google.com/mail/u/0/), [LinkedIn](https://www.linkedin.com/in/aamir-rafique-7a5bb1336/), [GitHub](https://github.com/Aamir-Rafique).
183+
184+
---
185+
186+
> Made with ❤️ by Aamir-Rafique

public/images/SSQRCodeApp.png

161 KB
Loading

src/App.jsx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1+
import Footer from "./components/Footer"
12
import QRcodeGenerator from "./components/QRCodeGen"
23

34
function App() {
@@ -7,6 +8,7 @@ function App() {
78
{/* <div class="absolute inset-0 -z-10 h-full w-full bg-white [background:radial-gradient(125%_125%_at_50%_10%,#fff_40%,#63e_100%)]"></div> */}
89
<div class="absolute inset-0 -z-10 h-full w-full items-center px-5 py-24 [background:radial-gradient(125%_125%_at_50%_10%,#000_40%,#63e_100%)]"></div>
910
<QRcodeGenerator />
11+
<Footer/>
1012
</>
1113
)
1214
}

src/components/Footer.jsx

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
import React from 'react'
2+
3+
const Footer = () => {
4+
return (
5+
<footer className=" w-full text-[0.76rem] lg:text-[0.9rem] text-center absolute bottom-0 pb-3 text-black">
6+
<p className='text-white'>Made with ❤️ by <a href="https://github.com/Aamir-Rafique" target="_blank" rel="noopener"
7+
className="text-[#18cfbd] hover:underline hover:text-[#3d5683]">Aamir Rafique</a>
8+
</p>
9+
</footer>
10+
)
11+
}
12+
13+
export default Footer

0 commit comments

Comments
 (0)