{"id":27309169,"url":"https://github.com/emmanuelkeifala/startup-pub-dir","last_synced_at":"2026-05-01T04:42:08.973Z","repository":{"id":285103481,"uuid":"947364746","full_name":"EmmanuelKeifala/startup-pub-dir","owner":"EmmanuelKeifala","description":"Start Up Public Directory","archived":false,"fork":false,"pushed_at":"2025-03-29T14:12:44.000Z","size":1096,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T15:20:07.475Z","etag":null,"topics":["authjs","drizzle-orm","imagekit","neondb","nextjs15","public-directory","shadcn-ui"],"latest_commit_sha":null,"homepage":"https://startup-pub-dir.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EmmanuelKeifala.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-12T15:15:59.000Z","updated_at":"2025-03-29T14:12:48.000Z","dependencies_parsed_at":"2025-03-29T15:20:16.101Z","dependency_job_id":null,"html_url":"https://github.com/EmmanuelKeifala/startup-pub-dir","commit_stats":null,"previous_names":["emmanuelkeifala/startup-pub-dir"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmmanuelKeifala%2Fstartup-pub-dir","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmmanuelKeifala%2Fstartup-pub-dir/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmmanuelKeifala%2Fstartup-pub-dir/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EmmanuelKeifala%2Fstartup-pub-dir/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EmmanuelKeifala","download_url":"https://codeload.github.com/EmmanuelKeifala/startup-pub-dir/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248520657,"owners_count":21117905,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["authjs","drizzle-orm","imagekit","neondb","nextjs15","public-directory","shadcn-ui"],"created_at":"2025-04-12T05:22:55.564Z","updated_at":"2026-05-01T04:42:08.912Z","avatar_url":"https://github.com/EmmanuelKeifala.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Startup Directory Platform\n\nA comprehensive platform for discovering, connecting with, and evaluating startups. This enterprise-grade application provides tools for startups, job seekers, and administrators within a modern, scalable architecture.\n\n[![Next.js](https://img.shields.io/badge/Next.js-15-black?style=flat\u0026logo=next.js)](https://nextjs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5-blue?style=flat\u0026logo=typescript)](https://www.typescriptlang.org/)\n[![Tailwind CSS](https://img.shields.io/badge/Tailwind-4-38B2AC?style=flat\u0026logo=tailwind-css)](https://tailwindcss.com/)\n[![React](https://img.shields.io/badge/React-19-61DAFB?style=flat\u0026logo=react)](https://react.dev/)\n\n## Overview\n\nThis platform serves as a centralized directory for startups, providing valuable insights, job opportunities, and analytical data. It's designed for three primary user roles: administrators, startup owners, and general users, each with tailored experiences and capabilities.\n\n## A bug that is hunting me.\n Say you sign in or up and the auth state did not change.. kindly refresh the page.\n \n## Key Features\n\n### Core Functionality\n\n- **Authentication \u0026 Authorization**\n\n  - Secure JWT-based authentication flow ✅\n  - Role-based access control (RBAC) ✅\n  - Protected routes and API endpoints ✅\n  - Email verification system ✅\n\n- **Startup Directory**\n\n  - Comprehensive startup profiles with detailed information ✅\n  - Advanced search and filtering system ✅\n  - Categorization by industry and location ✅\n  - Rich media support for logos, team photos, and product showcase ✅\n\n- **User Management**\n  - Detailed user profiles with customizable avatars\n  - Permission-based access control\n  - Account management tools\n  - User activity tracking\n\n### Advanced Capabilities\n\n- **Analytical Insights**\n\n  - Startup profile view tracking and analytics ✅\n  - User engagement metrics ✅\n  - Geographical distribution of visitors\n  - Performance benchmarking against similar startups ✅\n\n- **Review Ecosystem**\n\n  - User-generated reviews with rating system ✅\n  - Sentiment analysis on review content ✅\n\n- **Job Board**\n\n  - Comprehensive job listings with advanced search ✅\n  - Industry-specific categorization ✅\n  - Keyword-based filtering ✅\n\n- **Administrative Controls**\n  - Comprehensive dashboard for platform management ✅\n  - Startup verification process ✅\n  - Review moderation system ✅\n  - Analytics and reporting tools ✅\n  - User management interface ✅\n\n## Technology Stack\n\n### Frontend Architecture\n\n- **Framework**: Next.js 15 with App Router\n- **UI Library**: React 19 with Server Components\n- **Styling**: Tailwind CSS 4 with custom design system\n- **Component Library**: Custom UI components built on Radix UI primitives\n- **State Management**: React Context API with Server Actions\n- **Forms**: React Hook Form with Zod validation\n- **Animations**: Framer Motion\n- **Data Visualization**: Recharts\n\n### Backend Infrastructure\n\n- **API Layer**: Next.js API Routes and Server Actions\n- **Authentication**: NextAuth.js v5\n- **Database ORM**: Drizzle ORM\n- **Database**: NeonDB (Serverless PostgreSQL)\n- **Image Management**: ImageKit CDN\n\n### Analytics \u0026 Intelligence\n\n- **Natural Language Processing**: Sentiment analysis for reviews\n- **Analytics Engine**: Custom analytics tracking system\n- **Performance Monitoring**: Real-time view tracking\n- **Business Intelligence**: Custom reporting tools\n\n## Installation \u0026 Setup\n\n### Prerequisites\n\n- Node.js 18+\n- pnpm 8+ (recommended), npm, or Yarn\n- NeonDB account (or other PostgreSQL database)\n- ImageKit account for image CDN\n- Environment supporting JavaScript runtimes\n\n### Local Development Setup\n\n1. **Clone the repository**\n\n   ```bash\n   git clone https://github.com/EmmanuelKeifala/startup-pub-dir.git\n   cd startup-pub-dir\n   ```\n\n2. **Install dependencies**\n\n   ```bash\n   npm install  --force, or --legacy-peer-deps\n   ```\n\n3. **Configure environment variables**\n   Create a `.env.local` file in the project root:\n\n   ```\n   # Database Configuration\n   DATABASE_URL=\"postgresql://user:password@host:port/database\"\n\n   # Authentication\n   AUTH_SECRET=\"your-secure-auth-secret\"\n   NEXTAUTH_URL=\"http://localhost:3000\"\n\n   # ImageKit Configuration\n   NEXT_PUBLIC_IMAGEKIT_URL_ENDPOINT=\"\"\n   NEXT_PUBLIC_IMAGEKIT_PUBLIC_KEY=\"\"\n   IMAGEKIT_PRIVATE_KEY=\"\"\n  \n   ```\n\n4. **Initialize the database schema**\n\n   ```bash\n   npx drizzle-kit generate\n   ```\n   ```bash\n   npx drizzle-kit migrate\n   ```\n\n5. **Run the development server**\n   ```bash\n   npm run dev\n   ```\n   The application will be available at `http://localhost:3000`\n\n## Project Architecture\n\nThis is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).\n\n## Getting Started\n\nFirst, run the development server:\n\n```bash\nnpm run dev\n# or\nyarn dev\n# or\npnpm dev\n# or\nbun dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) with your browser to see the result.\n\n## Deploy on Vercel\n\nThe easiest way to deploy Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template\u0026filter=next.js\u0026utm_source=create-next-app\u0026utm_campaign=create-next-app-readme) from the creators of Next.js.\n\nCheck out [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femmanuelkeifala%2Fstartup-pub-dir","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femmanuelkeifala%2Fstartup-pub-dir","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femmanuelkeifala%2Fstartup-pub-dir/lists"}