0kpi

A goal-tracking app with financial accountability. Set goals, make pledges, and get charged if you don't complete them.

Features

• Create and track personal goals
• Set pledge amounts ($0.50 - $10,000)
• Automatic payment capture on failed goals
• Real-time goal feed
• User authentication with Clerk
• Stripe payment processing

Tech Stack

• Frontend: Next.js 14, React, TypeScript, Tailwind CSS
• Backend: Convex
• Auth: Clerk
• Payments: Stripe
• UI: Shadcn/ui components

Quick Start

# Clone and install
git clone https://github.com/vaurenw/0kpi.git
cd 0kpi
npm install

# Set up environment
cp example.env .env.local
# Fill in your API keys

# Run development server
npm run dev

# Deploy to production
npm run build
npm start

Environment Variables

Copy example.env to .env.local and add your API keys:

Required Variables

• NEXT_PUBLIC_CONVEX_URL - Convex deployment URL
• NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY - Clerk publishable key
• CLERK_SECRET_KEY - Clerk secret key
• STRIPE_SECRET_KEY - Stripe secret key (starts with sk_)
• NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY - Stripe publishable key (starts with pk_)
• STRIPE_WEBHOOK_SECRET - Stripe webhook secret (starts with whsec_)
• INTERNAL_API_KEY - Secure random string for internal API authentication
• NEXT_PUBLIC_APP_URL - Your app URL (e.g., http://localhost:3000 for development)

Optional Variables

• CRON_SECRET - Secure random string for cron job authentication
• RESEND_API_KEY - For email notifications (optional)
• FROM_EMAIL - Email address for notifications (optional)

Convex Commands

# Start Convex dev server
npx convex dev

# Deploy to production
npx convex deploy

Docs

• Stripe Documentation
• Convex Documentation
• Clerk Documentation

License

MIT