Unparty Logo

PROJECT

the app for organization

theunpartyproject

Location: unparty-app/theunpartyproject
Status: Active Development
Primary Purpose: Public-facing blog and content platform showcasing UNPARTY philosophy and creator stories

Overview

theunpartyproject is the public-facing blog and content platform for UNPARTY. It serves as a digital workspace and storytelling hub where creators, founders, and innovators share their journeys and inspire others to start building. The platform embodies the UNPARTY philosophy: start somewhere, embrace iteration, and create on your own terms.

Tech Stack

  • Framework: Next.js 13 (App Router)
  • Language: TypeScript
  • Content: MDX with Contentlayer
  • Styling: Tailwind CSS
  • Backend: Upstash Redis
  • Deployment: Vercel
  • Analytics: Vercel Analytics & Beam Analytics
  • Package Manager: pnpm

Key Features

  • MDX-Powered Blog: Rich content creation with MDX support for interactive, component-based articles
  • Project Showcase: Dynamic project pages featuring creator stories and case studies
  • Content Management: Contentlayer integration for type-safe content transformation
  • Responsive Design: Mobile-first design with Tailwind CSS
  • Custom Typography: Brandon Grotesque font family for distinctive branding
  • SEO Optimized: Open Graph metadata, Twitter cards, and structured data
  • Analytics Integration: Dual analytics setup with Vercel and Beam for comprehensive tracking
  • Code Highlighting: Rehype Pretty Code with GitHub Dark theme for beautiful code snippets
  • Auto-linking Headers: Automatic anchor links for all headings
  • Contact System: Direct connection pathway for users to reach out

Architecture

Code

Blog Platform (Next.js)
├── Public Routes
│   ├── / (Landing page)
│   ├── /projects (Blog listing)
│   ├── /projects/[slug] (Individual posts)
│   └── /contact (Contact form)
├── Content Layer
│   ├── MDX Processing (Contentlayer)
│   ├── Remark Plugins (GitHub Flavored Markdown)
│   └── Rehype Plugins (Code highlighting, headings)
├── Styling System
│   ├── Tailwind CSS (Utility classes)
│   ├── Custom Fonts (Brandon Grotesque)
│   └── Global Styles
└── Backend Services
    ├── Upstash Redis (Session/cache)
    └── Vercel Analytics (Tracking)

Content Structure

Projects (Blog Posts)

Located in content/projects/, each post is an MDX file with frontmatter:

yaml

---
title: "Post Title"
description: "Brief description"
date: "2024-04-20"
published: true
url: "https://example.com"  # Optional
repository: "github-url"     # Optional
image: "image-url"           # Optional
---

Supported Fields

  • title: Post title (required)
  • description: Brief summary (required)
  • date: Publication date
  • published: Boolean to show/hide post
  • url: External link (optional)
  • repository: GitHub repository (optional)
  • image: Featured image (optional)

Integration Points

  • Vercel: Hosting and deployment with automatic builds
  • Upstash Redis: Backend data storage and caching
  • Contentlayer: Static content transformation at build time
  • Vercel Analytics: User behavior and performance metrics
  • Beam Analytics: Additional analytics tracking
  • Custom Fonts: Brandon Grotesque via local font files
  • S3 (AWS): Image hosting for branding assets

Getting Started

Prerequisites

  • Node.js 16+
  • pnpm package manager

Installation

bash

# Clone the repository
git clone https://github.com/unparty-app/theunpartyproject.git
cd theunpartyproject

# Install dependencies
pnpm install

# Set up environment variables
cp .env.example .env
# Add your Upstash Redis credentials to .env

# Run development server
pnpm dev

The application will be available at http://localhost:3000.

Build

bash

# Build for production
pnpm build

# Start production server
pnpm start

Code Formatting

bash

# Format code with Rome
pnpm fmt

Business Value

ABOUT: Understanding UNPARTY Philosophy

  • Shares authentic creator stories and journeys
  • Demystifies the process of building and launching
  • Provides transparent insights into failures and iterations
  • Helps users understand what UNPARTY represents: starting somewhere

BUILD: Inspiring Creation

  • Showcases real projects built by creators
  • Demonstrates practical applications of ideas
  • Provides templates and patterns through content
  • Encourages users to overcome fear of failure and begin building

CONNECT: Facilitating Community

  • Creates connection points between creators and audience
  • Enables direct communication through contact system
  • Links to broader UNPARTY ecosystem (Founders Circle)
  • Builds trust through transparent storytelling

Relationship to Ecosystem

theunpartyproject serves as the public content hub within the UNPARTY ecosystem:

Connections to Other Repositories

  • theunpartyapp: May reference or link to the main web application
  • theunpartyunppp: Blog posts may discuss the native app journey
  • theunpartyrunway: Development insights may be shared as blog content
  • theunpartycrawler: Analytics from crawler may inform content strategy

Role in User Journey

  1. Discovery: Users land on theunpartyproject to learn about UNPARTY
  2. Inspiration: Read creator stories and case studies
  3. Exploration: Navigate to Founders Circle or other UNPARTY properties
  4. Connection: Reach out via contact form to engage further

Data Flow

Code

Users → theunpartyproject (Blog) → Inspiration & Education
   ↓
   → Founders Circle (Community)
   → theunpartyapp (Main Platform)
   → Contact (Direct Connection)

Project Philosophy

From the inaugural post (420.mdx):

"UNPARTY is my digital workspace, a place where I hope to connect with others and expand through diverse perspectives. Yes, I'm scared it might fail—that's human. But from the moment I posted a photo of my handwriting on a makeshift GoDaddy site, I've felt pride with every iteration. If fear of failure or others' opinions is holding you back, just start somewhere. That first step can make all the difference."

This repository embodies:

  • Iteration over perfection: Multiple versions, constant evolution
  • Transparency: Sharing both successes and failures
  • Accessibility: Removing barriers to entry for creators
  • Community: Building connections through shared experiences
  • Action: Prioritizing "start somewhere" over endless planning

Key Pages

  • / - Landing page with UNPARTY introduction and philosophy
  • /projects - Blog post listing with project showcases
  • /projects/[slug] - Individual blog post pages
  • /contact - Direct connection form
  • External: Founders Circle - Community platform

Content Highlights

Current blog posts cover:

  • Personal journey and UNPARTY evolution (420.mdx)
  • Technical tutorials (customfonts.mdx, tailwindcss.mdx)
  • Creator spotlights (alterego.mdx, nextstepengineer.mdx)
  • Project showcases (unkey.mdx, qstash.mdx)
  • Cultural commentary (torturedpoets.mdx, thirtyxthirty.mdx)

Deployment

Production: https://unparty.app
Platform: Vercel
Deploy Method: Automatic on push to main branch

Deploy with Vercel

Development Standards

  • Type Safety: Full TypeScript implementation
  • Code Quality: Rome for linting and formatting
  • Content Validation: Contentlayer schema enforcement
  • Responsive: Mobile-first design approach
  • Performance: Vercel Speed Insights monitoring
  • SEO: Comprehensive metadata and sitemap

Environment Variables

Required environment variables (see .env.example):

Code

UPSTASH_REDIS_REST_URL=your_upstash_url
UPSTASH_REDIS_REST_TOKEN=your_upstash_token

Contributing

This repository follows UNPARTY standards:

  1. Start with intention, not perfection
  2. Share early and iterate
  3. Document as you build
  4. Prioritize authenticity over polish
  5. Embrace failure as part of the process

License

See LICENSE file for details.

Last Updated: 2025-10-30
Maintained By: UNPARTY Team
Status: ✅ Active Development

"If fear of failure or others' opinions is holding you back, just start somewhere. That first step can make all the difference."