Skip to content

alexcraviotto/piecatcher

Repository files navigation

🍰 Piecatcher

Analyze apps in the app stores and identify weaknesses and opportunities in their strategies.

Piecatcher Logo

πŸš€ About Piecatcher

Piecatcher is a powerful analytics platform that helps you identify market opportunities in the app stores. By analyzing apps' monetization strategies and performance metrics, Piecatcher helps you capture that crucial 1% market share by identifying weaknesses and opportunities in your competitors' strategies.

✨ Key Features

  • πŸ” Deep app store analysis
  • πŸ’° Revenue and monetization insights
  • πŸ“Š Competitive analysis dashboard
  • πŸ€– AI-powered recommendations
  • πŸ“± Cross-platform compatibility

πŸ› οΈ Technology Stack

  • Frontend: Next.js with TypeScript
  • Database: Turso (LibSQL)
  • AI Models: Google Gemini
  • Scraping Service: Custom Node.js service
  • Documentation: Scalar

πŸ—οΈ Architecture

The application consists of two main services:

  1. Frontend Service: A Next.js application that handles the user interface and API endpoints
  2. Scraping Service: A dedicated service for gathering app store data

πŸ“š Documentation

Our comprehensive documentation is available in the /docs directory and is powered by Scalar. The documentation includes:

  • API references
  • Integration guides
  • AI model specifications (using Gemini)
  • Deployment guides

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • Docker and Docker Compose
  • A Turso account
  • Google Cloud account (for Gemini API)

Environment Variables

Create a .env file with the following variables:

TURSO_DATABASE_URL=your_turso_url
TURSO_AUTH_TOKEN=your_turso_token
NEXT_PUBLIC_API_URL=http://localhost:3000
GOOGLE_GENERATIVE_AI_API_KEY=your_gemini_api_key
NODE_ENV=development
NEXT_PUBLIC_SCRAPING_API_URL=http://localhost:8081

Local Development

  1. Clone the repository:
git clone https://github.com/alexcraviotto/piecatcher
cd piecatcher
  1. Install dependencies:
npm install
  1. Start the development environment:
docker-compose up -d
  1. The application will be available at:

πŸš‚ Deployment

Railway Deployment

The scraping service is optimized for Railway deployment. You can deploy directly using the Railway button above.

For manual deployment:

  1. Create a new project in Railway
  2. Connect your repository
  3. Add the required environment variables
  4. Deploy!

Frontend Deployment

The frontend can be deployed to any platform that supports Next.js applications (Vercel, Railway, etc.).

🀝 Contributing

We welcome contributions! Please see our contributing guide for details.

πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

🌟 Support

If you find Piecatcher helpful, please give it a star ⭐️ on GitHub!

About

🍰 Analyze apps in the app stores and identify weaknesses and opportunities in their strategies.

Resources

License

Stars

Watchers

Forks

Contributors