AI-powered product listing generator for online sellers and side hustlers.
Turn basic product details into editable, platform-specific e-commerce listings using configurable AI models.
Live Demo · GitHub Repository · Report an Issue
ListingLab helps independent sellers, small businesses, crafters, and entrepreneurs create product listings for marketplaces such as Shopify, Etsy, Amazon, eBay, and WooCommerce.
Enter your product details, select a target platform, and generate listing content that you can review, edit, copy, and export.
Built for the DEV Challenge: Hacktoberfest 2026 — Week 2, Side Hustle.
- Platform-specific generation: Adapts listing content and tone to the selected marketplace.
- Complete listing output: Generates a product title, short description, five selling points, detailed description, search tags, and a social media caption.
- Grounded product descriptions: Instructs the AI to use supplied product information and avoid inventing specifications or unsupported claims.
- Inline editing: Modify generated content before using it.
- Copy and export: Copy individual sections or the complete listing and export results as Markdown or JSON.
- Example presets: Try the application with sample products.
- Demo mode: Explore the interface without configuring a live AI provider.
- Configurable AI providers: Supports configured OpenAI-compatible inference endpoints, including Groq and local Ollama.
- Input validation: Validates requests and handles generation errors.
| Component | Technologies |
|---|---|
| Frontend | React 19, TypeScript, Vite |
| Styling | Tailwind CSS |
| Backend | Node.js, Express, TypeScript |
| Validation | Zod |
| AI integration | OpenAI-compatible API adapter |
| AI inference | Groq (openai/gpt-oss-120b) and compatible alternatives |
| Testing | Vitest |
| Deployment | Render |
ListingLab/
├── client/
│ └── src/
│ ├── components/
│ ├── data/
│ ├── services/
│ ├── App.tsx
│ └── types.ts
├── server/
│ ├── src/
│ │ ├── ai/
│ │ ├── middleware/
│ │ ├── routes/
│ │ ├── config.ts
│ │ ├── server.ts
│ │ └── index.ts
│ └── tests/
├── package.json
├── .env.example
└── README.md
- Node.js 20 or later
- npm 9 or later
- An API key for a supported AI provider, or a local Ollama installation
git clone https://github.com/Tanmaypatil-25/ListingLab.git
cd ListingLabnpm run install:allCreate a .env file from the example.
Windows PowerShell
Copy-Item .env.example .envmacOS / Linux
cp .env.example .envFor Groq, configure the following values in .env:
PORT=3001
CLIENT_ORIGIN=http://localhost:5173
AI_PROVIDER=groq
AI_MODEL=openai/gpt-oss-120b
AI_BASE_URL=https://api.groq.com/openai/v1
AI_API_KEY=your_groq_api_key
AI_TIMEOUT_MS=45000Get an API key from the Groq Console.
Never commit your actual .env file or expose your API key in frontend code.
npm run devOpen http://localhost:5173 in your browser.
Set the provider, model, API base URL, and API key in .env as shown above. Model availability and rate limits depend on Groq.
Install Ollama and download a compatible model:
ollama run llama3.2Configure .env for local inference:
AI_PROVIDER=ollama
AI_MODEL=llama3.2
AI_BASE_URL=http://localhost:11434/v1
AI_API_KEY=ollamaEnsure the Ollama service is running and accessible to the backend.
Other providers may work if their endpoints, authentication, model identifiers, and response formats are compatible with the configured adapter.
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/health |
Checks backend health |
GET |
/api/status |
Returns sanitized provider configuration status |
POST |
/api/generate |
Validates product input and generates a listing |
Refer to the server source code for request and response schemas.
Run the automated tests:
npm testBuild the frontend and backend:
npm run buildTests cover input validation, prompt construction, response parsing, and provider configuration and error handling.
ListingLab is deployed on Render:
To deploy your own instance:
- Connect your GitHub repository to Render.
- Create a Web Service using the repository root as the root directory.
- Set the build command to
npm run render-build. - Set the start command to
npm start. - Configure the required AI environment variables in Render.
- Deploy and verify the application, API health endpoint, and actual AI generation.
The production server serves the built frontend and API from the same origin.
- API credentials should remain server-side.
- Incoming requests are validated before processing.
- AI-generated content may contain inaccurate information. Review product details and claims before publishing.
- Provider availability, rate limits, and usage costs depend on the selected service.
- Free hosting may introduce cold starts or usage restrictions.
Contributions, bug reports, and feature suggestions are welcome.
- Fork the repository.
- Create a feature branch.
- Make your changes and add tests where appropriate.
- Run the test suite and production build.
- Open a pull request describing your changes.
This project is licensed under the MIT License. See the LICENSE file for details.