APP
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 developmentInstallation
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:seedUsage
bash
# Start development server with Turbopack (~3 seconds)
npm run dev
# Server starts at http://localhost:3000
# Run full production build
npm run buildConfiguration
| Variable | Required | Default | Description |
|---|---|---|---|
DATABASE_URL | Yes | file:./dev.db | Database connection string (SQLite path for local dev, PostgreSQL URL for production) |
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY | Yes | - | Clerk authentication publishable key |
CLERK_SECRET_KEY | Yes | - | Clerk authentication secret key |
STRIPE_SECRET_KEY | No | - | Stripe API key for payment processing |
SLACK_WEBHOOK_URL | No | - | 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)Related Repositories
| Repository | Relationship |
|---|---|
unparty-app/theunpartyrunway | Development automation and sprint planning |
unparty-app/theunpartycrawler | Analytics intelligence and content processing |
unparty-app/theunpartyunppp | Native iOS app sharing authentication and design |
unparty-app/theunpartyapi | Backend API service for hybrid search |
License
See LICENSE.md for details.