{"id":21233568,"url":"https://github.com/techtronixx/formify-formgenerator","last_synced_at":"2025-03-15T02:43:44.043Z","repository":{"id":262708536,"uuid":"888099329","full_name":"TechTronixx/Formify-FormGenerator","owner":"TechTronixx","description":"A modern web application that leverages AI to generate dynamic forms instantly with google form and xml export.","archived":false,"fork":false,"pushed_at":"2025-02-12T20:11:07.000Z","size":9029,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-12T21:24:52.522Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TechTronixx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2024-11-13T20:14:56.000Z","updated_at":"2025-02-12T20:11:10.000Z","dependencies_parsed_at":"2024-11-13T21:31:02.721Z","dependency_job_id":"7e826700-a66d-41a6-8686-af27e86dfd62","html_url":"https://github.com/TechTronixx/Formify-FormGenerator","commit_stats":null,"previous_names":["techtronixx/formify-formgenerator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechTronixx%2FFormify-FormGenerator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechTronixx%2FFormify-FormGenerator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechTronixx%2FFormify-FormGenerator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechTronixx%2FFormify-FormGenerator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TechTronixx","download_url":"https://codeload.github.com/TechTronixx/Formify-FormGenerator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243676703,"owners_count":20329432,"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":[],"created_at":"2024-11-20T23:59:26.038Z","updated_at":"2025-03-15T02:43:44.030Z","avatar_url":"https://github.com/TechTronixx.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI Form Builder\n\nA modern web application that leverages AI to generate dynamic forms instantly with google form and xml export.\n\n## Overview\n\nAI Form Builder simplifies form creation by using artificial intelligence to generate complete form structures from natural language descriptions. Perfect for developers, product managers, and anyone who needs to quickly create professional forms.\n\n## Form Builder Preview\n\nhttps://github.com/user-attachments/assets/2b79b3d0-f358-45f5-b350-19351eec0593\n\n\n## Demo Screenshots\n![Form Builder Interface](https://github.com/TechTronixx/Formify-FormGenerator/blob/main/Assets/Demo-1.png?raw=true)\n_Forms Preview_\n\n![Form Preview](https://github.com/TechTronixx/Formify-FormGenerator/blob/main/Assets/Demo-2.png)\n_Generated form preview with a custom prompt_\n\n![Form Export Options](https://github.com/TechTronixx/Formify-FormGenerator/blob/main/Assets/Demo-5.png)\n_Settings and Export Options_\n\n![Form Export Options](https://github.com/TechTronixx/Formify-FormGenerator/blob/main/Assets/Demo-4.png)\n_Generated form preview with another custom prompt_\n\n\n## Diagram Overview \n\u003cimg width=\"1374\" alt=\"image\" src=\"https://github.com/user-attachments/assets/5cfe8320-7b62-47bd-b407-6ac16f421a68\" /\u003e\n\n## Key Features\n\n- **AI-Powered Generation**: Create forms using simple text descriptions\n- **Real-time Preview**: Instantly view your generated forms [todo]\n- **Theme Support**: Built-in dark/light mode\n- **Google Forms Export**: Export your forms directly to Google Forms\n- **XML Export**: Export your forms as XML\n- **Responsive Design**: Fully responsive across all devices [todo]\n\n## Technical Stack\n\n### Frontend\n\n- Vite\n- Tailwind CSS\n- Shadcn UI\n- React Hook Form\n- React Router\n\n### Backend\n\n- Express.js server\n- OpenAI API integration\n- Google Forms API integration\n- Hugging Face API integration\n\n## Getting Started\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/TechTronixx/Formify-FormGenerator.git\ncd Formify-FormGenerator\n```\n\n2. Install Bun (if not already installed):\n\n```bash\ncurl -fsSL https://bun.sh/install | bash\n```\n\n3. Install dependencies:\n\n```bash\nbun install\n```\n\n4. Set up environment variables:\n\n```bash\ncp .env.example .env\n```\n\nFill in your `.env` file with your credentials.\n\n5. Start development servers:\n\n```bash\n# Start both frontend and backend\nbun run dev:all\n\n# Or start them separately:\nbun run dev      # Frontend only\nbun run server   # Backend only\n```\n\n## Environment Setup\n\n1. Copy the example environment file:\n\n```bash\ncp .env.example .env\n```\n\n2. Update the `.env` file with your credentials:\n\n```env\nVITE_HUGGINGFACE_API_KEY=           # Get from Hugging Face\nOPENAI_API_KEY=                      # Get from OpenAI\n\n# Google OAuth (Required for Google Forms export)\nGOOGLE_CLIENT_ID=                    # Get from Google Cloud Console\nGOOGLE_REDIRECT_URI=                 # Default: http://localhost:3001/oauth2callback\nGOOGLE_REFRESH_TOKEN=                # Generated using 'bun run token'\n```\n\n3. For Google Forms integration, follow the \"Getting Google Forms Refresh Token\" section below to obtain the necessary credentials.\n\n## Getting Google Forms Refresh Token\n\nTo use the Google Forms export feature, you'll need to:\n\n1. Set up your Google Cloud Project and enable the Google Forms API\n2. Create OAuth 2.0 credentials (Client ID and Secret)\n3. Add them to your `.env` file\n4. Run the token script:\n   ```bash\n   bun run token\n   ```\n5. Follow the prompts to authorize the application\n6. Add the resulting refresh token to your `.env` file as `GOOGLE_REFRESH_TOKEN`\n\n## Available Scripts\n\n- `bun run dev` - Start frontend development server\n- `bun run server` - Start backend server\n- `bun run dev:all` - Start both frontend and backend\n- `bun run build` - Build for production\n- `bun run preview` - Preview production build\n- `bun run token` - Generate Google OAuth refresh token\n\n## Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the GNU Affero General Public License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- [Shadcn UI](https://ui.shadcn.com/)\n- [OpenAI](https://openai.com/)\n- [Google Forms API](https://developers.google.com/forms/api)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechtronixx%2Fformify-formgenerator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechtronixx%2Fformify-formgenerator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechtronixx%2Fformify-formgenerator/lists"}