APP

the app for thoughts
1 minute ago

theunpartyapp

Organization: unparty-app
Repository: unparty-app/theunpartyapp
Type: app
Status: Active Development
Primary Language: TypeScript

A Next.js web application serving as the primary marketing platform and content management system for the UNPARTY ecosystem, featuring an admin panel, article publishing, inventory management, and user engagement workflows.


Overview

theunpartyapp is an app that serves as the primary web presence for UNPARTY, providing a comprehensive admin panel, content publishing system, and user engagement features while integrating with the broader UNPARTY ecosystem.

It powers the ABOUT → BUILD → CONNECT framework that guides users through understanding UNPARTY's vision, creating content, and connecting with the community.


Tech Stack

  • Language: TypeScript 5.9.3
  • Framework / Runtime: Next.js 15 (App Router) with React 19
  • Key Dependencies: Prisma ORM, Clerk Authentication, Stripe Payments, Tailwind CSS, MDX
  • Platform: Vercel (with PostgreSQL, Blob Storage, Analytics)

Key Features

  • Content Management: MDX-powered articles with slug-based routing, admin publishing workflow, and media management
  • Admin Panel: Step/task management, user submissions review, question builder, and repository documentation pages
  • User Experience: Custom theme system, marketing pages, waitlist signup, and per-user progress tracking
  • Developer Tools: Investigation workflow CLI, automated asset generation, and full TypeScript coverage

Quick Start

Prerequisites

bash

# Required tools
# - Node.js 20.17.0+
# - npm 10.8.2+
# - PostgreSQL database OR SQLite for development

Installation

bash

# Clone the repo
git clone https://github.com/unparty-app/theunpartyapp.git
cd theunpartyapp

# Install dependencies (~60 seconds)
npm install

# Copy environment template
cp .env.example .env.local

# Generate Prisma client
npm run db:generate

# Push database schema
npm run db:push

# Seed database (optional)
npm run db:seed

Usage

bash

# Start development server with Turbopack (~3 seconds)
npm run dev

# Server starts at http://localhost:3000

# Run full production build
npm run build

Configuration

VariableRequiredDefaultDescription
DATABASE_URLYesfile:./dev.dbDatabase connection string (SQLite path for local dev, PostgreSQL URL for production)
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEYYes-Clerk authentication publishable key
CLERK_SECRET_KEYYes-Clerk authentication secret key
STRIPE_SECRET_KEYNo-Stripe API key for payment processing
SLACK_WEBHOOK_URLNo-Slack webhook for admin notifications

Copy .env.example to .env.local and fill in required values. See DATABASE_SETUP.md for detailed database configuration.


Architecture

Code

theunpartyapp
├── src/app/               — Next.js App Router pages and API routes
├── src/app/admin/         — Protected admin panel (articles, books, steps, users)
├── src/app/api/           — REST endpoints for data operations
├── src/app/components/    — Reusable React UI components
├── prisma/                — Database schema and migrations
├── scripts/               — Build automation and investigation tools
└── public/                — Static assets (images, SVGs, fonts)

RepositoryRelationship
unparty-app/theunpartyrunwayDevelopment automation and sprint planning
unparty-app/theunpartycrawlerAnalytics intelligence and content processing
unparty-app/theunpartyunpppNative iOS app sharing authentication and design
unparty-app/theunpartyapiBackend API service for hybrid search

License

See LICENSE.md for details.