Skip to content

smartdev09/startup-perks

Repository files navigation

Startup Perks Directory

A comprehensive directory of startup perks, credits, and programs - discover $1M+ in free resources for your startup.

Next.js TypeScript License: MIT

πŸš€ Features

  • 40+ Startup Perks - Curated collection of cloud credits, AI API access, and developer tools
  • Advanced Search & Filtering - Find perks by category, credit value, and keywords
  • SEO Optimized - Complete metadata, JSON-LD structured data, and sitemap generation
  • Static Generation - Lightning-fast performance with ISR (24-hour revalidation)
  • Dark Mode - Beautiful UI that adapts to your preference
  • Community Driven - Open for contributions via GitHub PRs

πŸ“¦ Tech Stack

πŸ—οΈ Monorepo Structure

startup_perks/
β”œβ”€β”€ packages/
β”‚   └── data/              # Shared data package
β”‚       β”œβ”€β”€ package.json
β”‚       └── src/
β”‚           └── perks/
β”‚               β”œβ”€β”€ startup-perks.ts  # All perk data (40+ perks)
β”‚               └── index.ts          # Helper functions & exports
└── apps/
    └── startup-perks/     # Main Next.js application
        β”œβ”€β”€ package.json
        β”œβ”€β”€ next.config.mjs
        β”œβ”€β”€ tailwind.config.ts
        └── src/
            β”œβ”€β”€ app/       # App Router pages
            β”‚   β”œβ”€β”€ page.tsx               # Homepage
            β”‚   β”œβ”€β”€ perks/
            β”‚   β”‚   β”œβ”€β”€ page.tsx           # Listing with filters
            β”‚   β”‚   β”œβ”€β”€ [id]/page.tsx      # Individual perks
            β”‚   β”‚   └── category/[category]/page.tsx
            β”‚   β”œβ”€β”€ contribute/page.tsx
            β”‚   β”œβ”€β”€ sitemap.ts
            β”‚   β”œβ”€β”€ robots.ts
            β”‚   └── manifest.ts
            β”œβ”€β”€ components/
            β”‚   β”œβ”€β”€ ui/             # shadcn components
            β”‚   β”œβ”€β”€ perks/          # Perk-specific components
            β”‚   └── layout/         # Header, Footer, PageLayout
            β”œβ”€β”€ lib/
            β”‚   β”œβ”€β”€ utils.ts        # Utilities
            β”‚   β”œβ”€β”€ constants.ts    # Site config
            β”‚   └── seo.ts          # SEO helpers
            └── data/
                └── queries.ts      # Data fetching functions

🚦 Getting Started

Prerequisites

  • Node.js 20.9.0 or higher
  • npm 9.0.0 or higher

Installation

# Clone the repository
git clone https://github.com/yourusername/startup-perks.git
cd startup_perks

# Install dependencies
npm install

# Start development server
npm run dev

The application will be available at http://localhost:3000.

Building for Production

# Create production build
npm run build

# Start production server
npm start

πŸ“ Available Scripts

Command Description
npm run dev Start development server
npm run build Create production build
npm start Start production server
npm run lint Run Biome linter
npm run format Auto-fix formatting issues

🎨 Key Features

Advanced Search & Filtering

  • Full-text search across company names, programs, descriptions
  • Multi-category filtering with visual badges
  • Sort options: by name, company, or credit value
  • URL state management: shareable filtered links
  • Real-time results with instant feedback

SEO Excellence

  • Dynamic metadata for every page with unique titles and descriptions
  • JSON-LD structured data: Product, ItemList, Organization, WebSite schemas
  • OpenGraph & Twitter Cards for social media
  • Sitemap generation with proper priorities (57+ pages)
  • Robots.txt configuration
  • ISR with 24-hour revalidation for fresh content

Static Generation

All pages are statically generated at build time:

  • 1 homepage
  • 1 perks listing page
  • 41 individual perk pages
  • 8 category pages
  • 1 contribute page

Total: 57 static pages for blazing-fast performance!

🀝 Contributing

We welcome contributions! Here's how you can help:

Adding a New Perk

  1. Fork the repository
  2. Edit packages/data/src/perks/startup-perks.ts
  3. Add your perk following the existing format
  4. Run npm run lint to check formatting
  5. Submit a pull request

See CONTRIBUTING.md for detailed guidelines.

Contribution Areas

  • 🎁 New Perks: Add missing startup programs
  • πŸ“ Updates: Fix outdated information
  • πŸ› Bug Fixes: Report or fix issues
  • ✨ Features: Suggest or implement improvements
  • πŸ“š Documentation: Improve guides and examples

πŸ“Š Project Stats

  • 40+ Perks: Covering cloud, AI, database, and more
  • $1M+ Value: Estimated total credit value
  • 8 Categories: Organized for easy browsing
  • 100% Static: No server-side rendering needed
  • SEO Score: 100/100 on Lighthouse

πŸ—‚οΈ Data Structure

Each perk in packages/data/src/perks/startup-perks.ts follows this format:

{
  id: "unique-kebab-case-id",        // Unique identifier
  company: "Company Name",            // Official company name
  name: "Program Name",               // Program name
  category: "cloud",                  // Category (cloud, ai, database, etc.)
  credits: "Up to $100,000",          // Credit value or discount
  description: "Brief description",   // 1-2 sentence summary
  eligibility: "Requirements",        // Who can apply
  applyUrl: "https://...",           // Direct application link
  featured: false,                    // Featured on homepage
}

🎯 Roadmap

  • Add more perks (target: 100+)
  • User reviews and ratings
  • Email notifications for new perks
  • API for third-party integrations
  • Analytics dashboard
  • Mobile app

πŸ“„ License

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

πŸ™ Acknowledgments

  • Built with Next.js
  • UI components from shadcn/ui
  • Inspired by the startup community
  • Data sourced from official company programs

πŸ’¬ Support

🌟 Show Your Support

If you find this project helpful, please consider:

  • ⭐ Starring the repository
  • πŸ› Reporting bugs
  • 🎁 Contributing new perks
  • πŸ“’ Sharing with others

Built with ❀️ for the startup community

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •