An open API service indexing awesome lists of open source software.

https://github.com/pawantech12/random-user-generator

A Responsive Random User Generator built with ReactJS and TailwindCSS, featuring customizable filters for age, gender, and nationality. Easily export generated user data in JSON or CSV format
https://github.com/pawantech12/random-user-generator

api random-user-generator random-user-generator-api react responsive tailwindcss website

Last synced: about 2 months ago
JSON representation

A Responsive Random User Generator built with ReactJS and TailwindCSS, featuring customizable filters for age, gender, and nationality. Easily export generated user data in JSON or CSV format

Awesome Lists containing this project

README

        

# Responsive Random User Generator

A fully responsive **Random User Generator** built with **ReactJS** and styled using **TailwindCSS**. This application allows users to generate random profiles based on customizable filters such as age, gender, and nationality. It also includes options to **export** the generated data in **JSON** and **CSV** formats.

## Features

- **Custom Filters**:
- Set **minimum** and **maximum age** to generate profiles within a specific age range.
- Filter users by **gender** (Male, Female, or Other).
- Choose **nationality** from a list of available countries.

- **Data Export**:
- Export generated profiles to **JSON** or **CSV** format with a single click.

- **Responsive Design**:
- Built to be fully responsive, ensuring optimal viewing on all devices (desktop, tablet, mobile).

## Installation

To get started with the project, follow these steps:

1. **Clone the repository**:
```bash
git clone https://github.com/pawantech12/random-user-generator.git
```

2. **Navigate to the project directory**:
```bash
cd random-user-generator
```

3. **Install dependencies**:
```bash
pnpm install
```

4. **Start the development server**:
```bash
pnpm run dev
```

The app will be available at `http://localhost:5173`.

## Usage

Once the app is running, you can:

1. Use the filters to customize the age, gender, and nationality of the generated users.
2. Click on the **Generate** button to create random user profiles based on your selected filters.
3. To export the generated data, click the respective **Export to JSON** or **Export to CSV** buttons.

## Technologies Used

- **ReactJS**: For building the dynamic user interface.
- **TailwindCSS**: For creating a responsive and clean design.
- **CSV and JSON Export Libraries**: To handle the export functionality.

## Contributing

Feel free to fork the repository and submit pull requests. Contributions are welcome!

1. Fork the repository
2. Create a new branch (`git checkout -b feature-branch`)
3. Commit your changes (`git commit -am 'Add new feature'`)
4. Push to the branch (`git push origin feature-branch`)
5. Open a pull request

## License

This project is free to use and customize.