Welcome to the USA States Information Project! This project provides comprehensive information about the states of America through an easy-to-use web application. The application consists of three main sections: Home, Zip, and Find.
Check out the live preview of the project here.
- Home: Browse a list of all states. Click on a state to view detailed information about it.
- Zip: View a page listing ranges of zip codes.
- Find: Enter a zip code to find the corresponding city and state.
This project is built with:
- Next.js: A React framework for server-side rendering and generating static websites.
- pnpm: A fast, disk space-efficient package manager.
- "@tabler/icons-react": "^3.6.0", "clsx": "^2.1.1", "framer-motion": "^11.2.10", "next": "14.2.4", "react": "^18", "react-dom": "^18", "tailwind-merge": "^2.3.0"
To run this project locally, you need to have pnpm installed. Follow these steps to get started:
-
Clone the repository:
git clone [email protected]:MustafaM257/states-usa.git cd states-usa.git
-
Install dependencies:
pnpm install
-
Run the development server:
pnpm run dev
-
Open your browser and navigate to:
http://localhost:3000
The Home section lists all the states. Clicking on a state will navigate you to a dedicated page with detailed information about that state.
The Zip section displays a comprehensive list of zip code ranges.
The Find section allows you to enter a zip code and get the corresponding city and state.
This project is provided free of charge. I am an open-source enthusiast and take no responsibility for the usage of this project. Feel free to contribute and make it better!
Contributions are welcome! If you want to contribute to the project, please follow these steps:
- Fork the repository.
- Create a new branch.
- Make your changes.
- Submit a pull request.
For any inquiries or feedback, please contact me at:
- Email: [email protected]
- GitHub: MustafaM257
Feel free to make any adjustments or add more details as needed.