A dashboard for Hack Club's YSWS (You Ship, We Ship) program. Track your shipped projects, view stats, and see where your projects are being mentioned online.

• Dashboard - View all your shipped projects with screenshots, descriptions, and stats
• Virality Tracking - See where your projects are being mentioned across the web
• GitHub Stars - Track star counts on your repositories
• Stats Page - Global statistics about shipped projects
• API - RESTful API for accessing project data

• Ruby on Rails 8.0 with SQLite
• Hotwire (Turbo + Stimulus) for reactive UI
• Vite for asset bundling
• Solid Queue/Cache/Cable for background jobs, caching, and websockets
• OmniAuth (OpenID Connect) for authentication via Hack Club
• Flipper for feature flags
• Lockbox for field encryption
• Blazer for analytics

• Ruby 3.4.3
• Node.js 20+
• pnpm
• PostgreSQL (production) or SQLite (development)

# Install dependencies
bundle install
pnpm install



# Setup database
bin/rails db:prepare



# Start development server
bin/devv

Edit credentials with bin/rails credentials:edit:

hackclub_api:
   auth_key: "your-airbridge-auth-key"


slack:
   bot_token: "xoxb-..."

bin/rails server      # Start server
bin/rails console      # Rails console
bin/rails  test        # Run tests
bin/rubocop            # Lint
bin/rubocop -a         # Auto-fix lint issues

app/
├── controllers/     # Request handlers
├── jobs/           # Background jobs (Solid Queue)
├── models/         # ActiveRecord models
├── services/       # Service objects (HackclubAirtable)
└── views/          # ERB templates
ates

1. AirtableJob syncs projects from Hack Club's Airtable via api2.hackclub.com
2. Projects stored in ysws_project_entries table
3. Users authenticate via Hack Club OAuth
4. Dashboard shows projects matching user's email

Deployed via Docker on Coolify. See Dockerfile and docker-compose.yml.

Persistent storage required for:

• /rails/storage (Active Storage files)

MIT

this is a temp ai generated readme