4ward

KO | EN

gitlite — search

#ruby #ai-agent #cli #list #animation #mcp #gpt #agents #http #nlp

(★ 9)

4ward is a SaaS marketplace platform that enables university students and developers to showcase, sell, and discover IT projects with secure digital transactions.

File Explorer

ZIP Download

- saas-modern.md
- - migration_lock.toml
- init.sql
- schema.prisma
- seed.ts
- apple-touch-icon.png
- favicon-16.png
- favicon-32.png
- favicon-48.png
- favicon.ico
- favicon.png
- file.svg
- globe.svg
- icon-dark.png
- icon-light.png
- logo-mark-dark.png
- logo-mark-mask.png
- logo-mark.png
- logo.png
- next.svg
- vercel.svg
- window.svg
- add-staff-roles.js
- admin-bootstrap.js
- apply-schema.js
- check-role-enum.js
- fix-env-pooler.js
- health-check.js
- list-db.js
- use-session-pooler.js
- - apple-icon.png
  - favicon.ico
  - globals.css
  - icon.png
  - layout.tsx
  - page.tsx
- - brand-logo.tsx
  - theme-provider.tsx
  - theme-toggle.tsx
  - university-select.tsx
  - verified-tick.tsx
- - admin-auth.ts
  - admin-config.ts
  - admin-session-client.ts
  - admin-session.ts
  - audit-classify.ts
  - auth.ts
  - clickpesa.ts
  - constants.ts
  - demo-data.ts
  - ensure-project.ts
  - env.ts
  - motion.ts
  - orders.ts
  - prisma.ts
  - production.ts
  - rate-limit.ts
  - rbac.ts
  - request-notifications.ts
  - security.ts
  - seller-profile.ts
  - session-user.ts
  - storage.ts
  - stripe.ts
  - tanzania-institutions.ts
  - university-exclusivity.ts
  - users.ts
  - utils.ts
  - validations.ts
- - use-app-store.ts
- middleware.ts
.env.example
.gitignore
AGENTS.md
BACKEND.md
CLAUDE.md
eslint.config.mjs
next.config.ts
package-lock.json
package.json
postcss.config.mjs
prisma.config.ts
README.md
skills-lock.json
tsconfig.json
vercel.json

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**Turn your projects into digital products.**

4ward is a full-stack SaaS marketplace where university students, developers, and IT creators sell completed academic and personal projects — source code, documentation, demos, and digital products. Buyers discover ready-made solutions across web, mobile, AI, cybersecurity, IoT, blockchain, and more.

Inspired by GitHub Marketplace, Gumroad, Envato Market, Product Hunt, and campus innovation hubs.

---

## Stack

| Layer | Tech |
|--------|------|
| Frontend | Next.js (App Router), TypeScript, Tailwind CSS, Framer Motion, Zustand, React Hook Form + Zod |
| UI | Custom Shadcn-style components, Lucide icons, Recharts |
| Backend | Next.js Route Handlers / Server Actions |
| Database | PostgreSQL + Prisma ORM |
| Auth | Clerk (email/password + Google OAuth) with RBAC |
| Storage | Supabase Storage (signed downloads) |
| Payments | Stripe + adapters for M-Pesa, AzamPay, Selcom |
| Deploy | Vercel |

---

## Features

- Premium dark landing page with glassmorphism, gradients, and motion
- Marketplace with category / price / tech / university / rating filters
- Project detail pages, demos, favorites, and checkout
- Sell flow: drafts → pending review → published, AI description generator
- Seller, buyer, and admin dashboards (analytics, orders, approvals, reports)
- Creator portfolio pages at `/username`
- Messaging UI, affiliate program, reputation badges
- Security: RBAC helpers, Zod validation, rate limiting, webhook verification, protected downloads, audit logs

---

## Getting started

### 1. Install

```bash
npm install
```

### 2. Environment

```bash
cp .env.example .env
```

Fill in:

- `DATABASE_URL` — PostgreSQL connection string
- Clerk keys (optional for demo browsing)
- Stripe keys (optional — demo checkout works without them)
- Supabase keys (optional — uploads return placeholders)

### 3. Database

```bash
npx prisma generate
npx prisma db push
```

### 4. Run

```bash
npm run dev
```

Open [http://localhost:3000](http://localhost:3000).

The UI ships with rich **demo data** so you can explore marketplace, dashboards, and sell flow before wiring live services.

---

## Scripts

| Command | Description |
|---------|-------------|
| `npm run dev` | Development server |
| `npm run build` | Production build |
| `npm run start` | Start production server |
| `npm run lint` | ESLint |
| `npm run db:generate` | Generate Prisma client |
| `npm run db:push` | Push schema to database |
| `npm run db:studio` | Prisma Studio |

---

## Roles

1. **Buyer** — browse, purchase, download, review, wishlist  
2. **Seller** — profile, listings, sales, analytics, payouts  
3. **Admin** — users, project approval, transactions, reports

Set Clerk `publicMetadata.role` to `BUYER` | `SELLER` | `ADMIN`.

---

## Payments

- **Stripe** Checkout + webhook at `/api/webhooks/stripe`
- Platform fee: **15%** (see `src/lib/constants.ts`)
- Affiliate commission: **10%**
- African gateways stubbed in `src/lib/stripe.ts` for M-Pesa, AzamPay, Selcom

---

## Project structure

```
src/
  app/                 # Routes (landing, marketplace, sell, dashboards, API)
  components/          # UI, layout, projects, landing, dashboard
  lib/                 # prisma, auth, stripe, storage, validations, demo-data
  store/               # Zustand (favorites, cart)
prisma/
  schema.prisma        # Full data model
```

---

## Deploy on Vercel

1. Push to GitHub  
2. Import in Vercel  
3. Add env vars from `.env.example`  
4. Set `DATABASE_URL` to a managed Postgres (Neon, Supabase, Prisma Postgres, etc.)  
5. Run `prisma migrate deploy` / `db push` in build or a release step

---

## License

Proprietary — built as a startup-ready SaaS foundation for 4ward.

4ward

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README