Skip to content

sarahlz01/spent

Repository files navigation

$pent - The Irresponsible Spending Generator

🎯 About

$pent is a fun, tongue-in-cheek web application that encourages irresponsible spending by generating random, quirky, and potentially useless items based on your budget. Perfect for those moments when you just want to make some questionable financial decisions!

✨ Features

  • 💰 Budget-based item generation
  • 🔍 Direct Amazon product search links
  • 🎲 Random and unique product suggestions
  • 💅 Clean and modern UI
  • 🤖 Powered by OpenAI's GPT
  • 🛍️ Real-time product recommendations

🛠️ Tech Stack

  • Framework: Next.js (App Router)
  • Styling: Tailwind CSS
  • AI Integration: OpenAI API
  • Deployment: Vercel
  • Language: TypeScript

🚀 Getting Started

Prerequisites

  • Node.js
  • npm
  • OpenAI API key

Installation

  1. Clone the repository:
git clone https://github.com/sarahlz01/spent.git
cd spent
  1. Install dependencies:
npm install
  1. Create a .env file in the root directory:
OPENAI_API_KEY=your_openai_api_key_here
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000 in your browser.

💭 How It Works

  1. User inputs their budget
  2. OpenAI generates quirky product suggestions
  3. Each product is linked to Amazon search results
  4. Products are displayed with names and prices
  5. Users can click through to view products on Amazon

📝 Environment Variables

The following environment variables are required:

  • OPENAI_API_KEY: Your OpenAI API key

🚢 Deployment

The project is deployed on Vercel. For deployment:

  1. Push your code to GitHub
  2. Import your repository to Vercel
  3. Add your environment variables
  4. Deploy!

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Made with ❤️ for questionable financial decisions

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors