Skip to content

shashwtd/survey-forge

Repository files navigation

SurveyForge 🚀

SurveyForge is an AI-powered survey creation platform that revolutionizes how you create and manage surveys. Simply describe what you want, and let our AI generate professional survey questions instantly.

🌟 Features

🤖 AI-Powered Survey Generation

  • Transform natural language descriptions into well-structured surveys
  • Get intelligent question suggestions based on your requirements
  • Save hours of manual survey creation time

📤 Multi-Platform Export

  • Export surveys to Google Forms
  • More platforms coming soon (TypeForm, SurveyMonkey, etc.)

🎨 Modern User Interface

  • Clean, intuitive dashboard
  • Dark mode support
  • Responsive design for all devices

🔒 Secure Authentication

  • Powered by Supabase authentication
  • Google Sign-in support
  • Secure user data handling

🚀 Live Demo

Visit surveyforge.xyz to try out the live version!

🛠️ Tech Stack

  • Frontend: Next.js 14, React 19, TailwindCSS
  • Backend: Next.js API Routes, Supabase
  • AI: Google Gemini API
  • Authentication: Supabase Auth
  • Database: Supabase PostgreSQL
  • Styling: TailwindCSS, Radix UI
  • Animations: GSAP

🏃‍♂️ Running Locally

Prerequisites

  • Node.js 18+
  • npm/yarn/pnpm
  • A Supabase account
  • A Google Cloud account (for Gemini API)

Environment Variables

Create a .env.local file in the root directory with:

# for auth & db
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

# currently, we only support gemini
GEMINI_API_KEY=your_gemini_api_key

# for google 0auth
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret

Installation

  1. Clone the repository
git clone https://github.com/shashwtd/survey-forge.git
cd survey-forge
  1. Install dependencies
npm install
# or
yarn install
# or
pnpm install
  1. Start the development server
npm run dev
# or
yarn dev
# or
pnpm dev

Open http://localhost:3000 to see the app running.

📝 Usage

  1. Sign in using your email or Google account
  2. Click "Create New Survey"
  3. Describe your survey requirements in natural language
  4. Review and edit the AI-generated questions
  5. Export to your preferred platform
  6. Share with your audience!

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📜 License

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

💖 Support

If you find SurveyForge helpful, consider:

🔗 Links


Built with ❤️ by shashwtd

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages