Skip to content

karozi/StackShelf.app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 

Repository files navigation

StackShelf.app

Transform your Substack into a dynamic creator storefront

Live Demo Built for Substack Made with Love

by Karo

🎯 What is StackShelf?

StackShelf is a discovery platform and storefront builder designed exclusively for the Substack creator community. It enables writers, journalists, and content creators to showcase their products, newsletters, and social presence in a beautiful, unified "shelf-in-bio" page.

✨ Key Features

  • 🎨 Beautiful Creator Profiles - Elegant bento-grid layouts that make your content shine
  • πŸ›οΈ Product Showcase - Display digital products, courses, books, and services
  • πŸ“¬ Newsletter Integration - Seamlessly connect your Substack publication
  • πŸ”— Social Media Hub - Consolidate all your social links in one place
  • πŸ“Š Creator Analytics - Track views, clicks, and engagement (creator's eyes only)
  • πŸ† Recognition Badges - Earn badges for contributions and achievements
  • 🀝 Collaboration Features - Connect with other creators for cross-promotion
  • πŸ“± Mobile-First Design - Looks stunning on all devices

πŸš€ For Creators

Getting Started

  1. Sign up at stackshelf.app using your Google account
  2. Confirm your Product With Attitude subscription (trust-based system)
  3. Build your shelf by adding products, linking your newsletter, and customizing your profile
  4. Share your unique shelf URL (stackshelf.app/shelf/yourname) everywhere

What You Can Add

  • Products: Digital downloads, courses, coaching services, books
  • Newsletter: Your Substack publication with custom card design
  • Social Links: Twitter/X, LinkedIn, Instagram, Bluesky, personal website
  • Featured Post: Highlight your best Substack article
  • Profile: Photo, bio, category, and collaboration status

πŸ› οΈ Tech Stack

StackShelf is built with modern web technologies for performance and reliability:

  • Frontend: React, TypeScript, Tailwind CSS, Vite
  • Backend: Node.js, Express, PostgreSQL
  • Authentication: Google OAuth
  • Hosting: Replit Deployments
  • UI Components: shadcn/ui, Radix UI
  • State Management: TanStack Query
  • ORM: Drizzle

πŸ—οΈ Architecture

StackShelf/
β”œβ”€β”€ client/          # React frontend application
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ pages/   # Route components
β”‚   β”‚   β”œβ”€β”€ components/ # Reusable UI components
β”‚   β”‚   └── lib/     # Utilities and helpers
β”œβ”€β”€ server/          # Express backend API
β”‚   β”œβ”€β”€ routes.ts    # API endpoints
β”‚   β”œβ”€β”€ storage.ts   # Database interface
β”‚   └── auth/        # Authentication logic
β”œβ”€β”€ shared/          # Shared types and schemas
└── uploads/         # User-uploaded content

🀝 Community & Ethics

StackShelf operates on trust and community values:

  • Indie-first: Built by creators, for creators
  • Trust-based: We trust you're a paying Substack subscriber
  • Privacy-focused: Your data stays yours
  • Community-driven: Features shaped by creator feedback
  • Fair monetization: No hidden fees, no data selling

🌟 Featured Creators

Discover amazing creators already using StackShelf:

  • Writers sharing their digital products
  • Journalists offering exclusive reports
  • Educators selling courses and workshops
  • Consultants showcasing their services

Browse all creators at stackshelf.app/meet-creators

πŸ›‘οΈ Security & Privacy

  • Secure Google OAuth authentication
  • No password storage - OAuth only
  • HTTPS encryption on all connections
  • Regular security updates
  • GDPR-compliant data handling

πŸ’¬ Support & Feedback

  • Help Center: DM Karo via Substack

πŸ“„ License

StackShelf is a proprietary platform. The service is provided as-is for Substack creators.

πŸ™ Acknowledgments

Built with 🧑 by Karo & tested by fellow Substackers who believe in empowering independent creators.

Special thanks to:

  • The Substack community for inspiration
  • Early adopters who shaped the platform
  • Contributors who helped build StackShelf

Visit StackShelf β€’ Browse Creators β€’ Discover Products

Made for the Substack community. If you're actively publishing, you're invited to join.