Perbee 🐝 The AI-Powered Personal Best Tracker. Stop trying to fit your unique progress into rigid spreadsheets. Whether it’s a heavy set of squats, a record-breaking coding sprint, or your fastest 5k, Perbee uses AI to build the perfect tracking form for your win, instantly. 🌟 Features

• Smart Recognition: Type any activity, and our AI identifies the category and intent.

• Dynamic Field Generation: Based on your PB type, Perbee generates specific fields:

  • Lifting: Mass, Reps, Sets, RPE.
  • Endurance: Distance, Time, Split.
  • Productivity: Pomodoros, Words Written, Lines of Code.

• Total Flexibility: Edit AI-generated fields or add your own custom metrics to any entry.

• The Trophy Case: A visual history of your growth across every aspect of your life. 🛠️ Installation Get your local environment up and running in minutes.

• Clone the repo: git clone https://github.com/yourusername/perbee.git cd perbee

• Install dependencies: npm install

• Set up Environment Variables: Create a .env file in the root directory and add your API keys: AI_MODEL_API_KEY=your_key_here DATABASE_URL=your_db_url

• Run the app: npm run dev

📖 How to Use

• Log a PB: Hit the + button and type what you achieved (e.g., "Incline Bench").
• Select Suggesion: Tap the AI-suggested category.
• Fill the Specs: Enter the data in the fields Perbee automatically created for you.
• Customize: Need to track "Sleep Quality" alongside your morning run? Tap + Add Field.
• Save & Celebrate: Hit save and watch your progress bar move. 🧬 Project Structure perbee/ ├── src/ │ ├── components/ # Reusable UI (Buttons, Inputs, Modals) │ ├── ai/ # Logic for PB analysis and field generation │ ├── hooks/ # Custom React hooks for state management │ └── store/ # Global state (Zustand/Redux) ├── public/ # Assets and branding └── ...

🤝 Contributing We love seeing how people track their wins!

• Fork the Project.
• Create your Feature Branch (git checkout -b feature/AmazingWin).
• Commit your Changes (git commit -m 'Add some AmazingWin').
• Push to the Branch (git push origin feature/AmazingWin).
• Open a Pull Request. 📄 License Distributed under the MIT License. See LICENSE for more information.

Built for the high-achievers. Record the win. Be better.