Skip to content

The Full-Stack Startup Application. We allow anyone to start with an idea for a startup, validate that idea, conduct user research, find potential users, employees, and investors - all in one place!

Notifications You must be signed in to change notification settings

ArshAnan/startup-stack

Repository files navigation

Startup Stack

A comprehensive startup development platform that helps entrepreneurs go from idea to MVP through AI-powered tools and guided workflows.

Features

  • Idea Generation: AI-powered startup idea generation
  • Idea Validation: Market research and validation tools
  • MVP Builder: Automated MVP creation with v0.dev integration
  • Talent Hub: Find and manage team members
  • User Feedback: Create and manage feedback surveys

Tech Stack

  • Frontend: Next.js 15, React 19, TypeScript
  • Styling: Tailwind CSS
  • State Management: React Context + useReducer for global state
  • AI Integration: Google Gemini, Perplexity API
  • UI Components: Custom components with Lucide React icons

Getting Started

  1. Install dependencies:

    npm install
  2. Set up environment variables (optional): Create a .env.local file with:

    GEMINI_API_KEY=your_gemini_api_key
    PERPLEXITY_API_KEY=your_perplexity_api_key
    V0_API_KEY=your_v0_api_key
    NEXT_PUBLIC_APP_URL=http://localhost:3000

    Note: API keys are optional! The app will work with sample data if no API keys are provided. This is perfect for development and testing.

  3. Run the development server:

    npm run dev
  4. Open your browser: Navigate to http://localhost:3000

Global State Management

This application uses React Context with useReducer for state management. All data (surveys, ideas, MVPs, talent applications) is stored in global state and persists during the session.

State Structure

  • Surveys: User feedback surveys with questions and responses
  • Applicants: Talent applications and candidate information
  • Ideas: Generated startup ideas and concepts
  • MVPs: MVP specifications and development plans

Usage

import { useSurveys, useApplicants, useIdeas, useMVPs } from "@/contexts/global-state";

function MyComponent() {
  const { surveys, addSurvey, updateSurvey, deleteSurvey } = useSurveys();
  const { applicants, addApplicant, inviteApplicant } = useApplicants();
  // ... use other hooks
}

API Endpoints

  • POST /api/surveys - Create a new survey
  • GET /api/surveys - Get all surveys
  • POST /api/ideas - Generate startup ideas
  • POST /api/mvp - Generate MVP specifications
  • POST /api/talent/invite - Invite talent applicants
  • GET /api/talent/applications - Get all talent applications

API Integration & Fallbacks

The application integrates with several AI services, but works perfectly without any API keys:

With API Keys (Production)

  • Gemini: Generates personalized startup ideas from resume analysis
  • Perplexity: Provides market validation and competitive analysis
  • v0.dev: Creates MVP designs and code repositories

Without API Keys (Development)

  • Sample Ideas: Pre-generated startup ideas for testing
  • Sample Validation: Mock market analysis data
  • Sample MVP: Placeholder design and repository links

This makes the app perfect for development, demos, and testing without requiring API key setup.

Development

The application is built with modern React patterns and includes:

  • Server-side API routes for external integrations
  • Client-side global state management
  • Type-safe TypeScript throughout
  • Responsive design with Tailwind CSS
  • Graceful fallbacks for missing API keys

About

The Full-Stack Startup Application. We allow anyone to start with an idea for a startup, validate that idea, conduct user research, find potential users, employees, and investors - all in one place!

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •