A fun, interactive web application for dog lovers to discover random cute dog images of various breeds.
- Random Dog Images: Fetch adorable dog photos with a single click
- Breed Detection: Automatically identifies and displays the dog breed
- Beautiful UI: Elegant animations and visual effects
- Image Counter: Tracks how many dogs you've discovered
- Responsive Design: Works on desktop, tablet, and mobile devices
- Fast Performance: Optimized images with Next.js Image component
- Next.js 15.1.7: React framework with App Router
- React 19: Latest version of React
- Node.js v22.13.1: JavaScript runtime
- TypeScript: For type-safe code
- TailwindCSS 3.4.1: For styling and animations
- Dog CEO API: Source of dog images data (https://dog.ceo/dog-api/)
- Vercel: Deployment and hosting
- Node.js 18.17 or later
- macOS, Windows, or Linux operating system
First, clone this repository:
git clone https://github.com/yourusername/Puppy-API.git
cd Puppy-API
Install dependencies:
npm install
# or
yarn install
# or
pnpm install
Then, run the development server:
npm run dev
# or
yarn dev
# or
pnpm dev
Open http://localhost:3000 with your browser to see the app.
The app fetches random dog images from the Dog CEO API and extracts breed information from the image URL. With each new image, it updates a counter to track how many dogs you've discovered.
The UI features subtle animations, including:
- Hover effects on dog images
- Pulsing and bouncing decorations
- Loading animations
- Interactive button effects
You can customize various aspects of the app:
- Change the color scheme by modifying the amber/gold tones in the TailwindCSS classes
- Add new animations or visual effects
- Implement breed filtering functionality
- Add favorites or a gallery feature
[Screenshots would be added here once the app is deployed]
This app is designed to work beautifully on all screen sizes:
- Desktop: Full experience with all animations
- Tablet: Optimized layout for medium screens
- Mobile: Compact design that maintains all functionality
This project uses the Dog CEO API, a free, public API for dog images.
This project is open source and available under the MIT License.
This is a Next.js project bootstrapped with create-next-app
.
The easiest way to deploy this application is using the Vercel Platform.
Check out the Next.js deployment documentation for more details.