https://github.com/teambit/product-cult
The Product Cult example platform. Generated by AI, refined by humans.
https://github.com/teambit/product-cult
Last synced: 4 months ago
JSON representation
The Product Cult example platform. Generated by AI, refined by humans.
- Host: GitHub
- URL: https://github.com/teambit/product-cult
- Owner: teambit
- License: other
- Created: 2025-06-12T23:39:17.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-06-13T01:38:12.000Z (7 months ago)
- Last Synced: 2025-06-13T02:24:23.532Z (7 months ago)
- Language: TypeScript
- Size: 1.02 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Product Cult 🗳️ A Hope AI Example Project
[](https://opensource.org/licenses/Apache-2.0)
Welcome to **Product Cult**! This is a fully functional example application generated using [**Hope AI**](https://bit.cloud) and refined by humans. It demonstrates how to compose a modern web application from independent, reusable components. The app itself is a fun platform where users can vote for their favorite next-generation product ideas.
This project serves as a practical guide to showcase AI-driven development, modular architecture, and rapid delivery with Hope AI.
Browse the components on the [Bit Cloud example organization](https://bit.cloud/infinity) for browsing live preview and of the platform components and business capabilities.
---
## ✨ Features
* **[Design system](https://bit.cloud/infinity/design):** Browse the [platform design system components](https://bit.cloud/infinity/design/~components). Each as standalone reusable package.
* **[User Authentication](https://bit.cloud/infinity/products):** Secure sign-up and login to enable voting and submissions.
* **[Real-Time Voting](https://bit.cloud/infinity/upvotes):** Cast your vote for product ideas and see the results update instantly.
* **[Product Submissions](https://bit.cloud/infinity/products):** Submit your own innovative product ideas for the community to vote on.
* **[Community Discussions](https://bit.cloud/infinity/forums):** Engage in threaded discussions on each product page.
* **[User Profiles](https://bit.cloud/infinity/people):** Manage your profile and track your submissions and voting history.
---
## 🛠️ Tech Stack
This project is built with a modern, component-oriented technology stack:
* **Monorepo:** [Bit](https://bit.dev) - For creating, versioning, and composing the platform packages.
* **Core Platform:** Used [TypeScript](https://www.typescriptlang.org/) and [Harmony](https://bit.dev/docs/harmony-intro) for composing and integrating the application's services and logic.
* **Frontend:** [React](https://reactjs.org/) - For building interactive and reusable UI components.
* **Styling:** CSS Modules - For locally scoped and conflict-free component styles.
* **Backend:** [NodeJS](https://nodejs.org) backend with [GraphQL](https://graphql.org) data fetching. Data persisted to [MongoDB](https://mongodb.com).
* **Code standards:** Unit tests powered by [Vitest](https://vitest.dev). Code consistency and quality enforced by [ESLint](https://eslint.org).
---
## 🚀 Getting Started
Follow these steps to get the Product Cult platform running on your local machine.
### Prerequisites
Make sure you have [Bit](https://bit.dev/docs/getting-started/installing-bit/installing-bit) and [MongoDB](https://www.mongodb.com/docs/manual/installation/) installed globally on your system.
### Installation & Setup
1. **Clone the repository** (or get the source code).
2. **Navigate into the project directory:**
```bash
cd path/to/product-cult
```
3. **Install dependencies** for all components in the workspace:
```bash
bit install
```
## Running the App
You can run the full application or view individual components in the Bit workspace.
This command builds and runs the main `product-cult` application, showing you the final, composed product:
```bash
bit run product-cult
```
Now, open your browser to the specified local port to see the app live!
### Start the Workspace Preview
This command launches the Bit development server, where you can see, test, and interact with each component in isolation. It's great for development and debugging.
```bash
bit start
```
## 📂 Project Structure
The directory structure is organized by components. This makes the codebase more modular, scalable, and easier to maintain. Enable, add or disable application features in the [application shell](https://github.com/teambit/product-cult/blob/main/product-hunt-platform/product-hunt/product-hunt.bit-app.ts).