Party Starter

Features

• The basics you love with Next.js, Tailwind CSS and shadcn/ui
• Quick Setup with Auth.js, drizzle and NeonDB
• Powerful Server-Actions with
  • ActionButton
  • CMD-K Menu
  • Keyboard-Shortcuts
  • streamToast()
  • streamDialog()

Setup

• Configure the features you want in starter.config.ts
• Run pnpm starter:init to setup the project
• Create .env.local
• Generate Auth Secret
  • run npx auth secret
  • copy AUTH_SECRET to .env.local
• Connect DB
  • Create Neon Database
  • DATABASE_URL: looks like postgresql://...
• Connect OAuth
  • Create Discord Developer App
  • Goto OAuth2
  • AUTH_DISCORD_ID: Copy Client ID
  • AUTH_DISCORD_SECRET: Reset Secret
  • Add Redirects:
  • http://localhost:3000/api/auth/callback/discord
  • https://your-app.com/api/auth/callback/discord
• Email
  • Specify an SMTP server
  • EMAIL_FROM="moin@party-starter.de"
  • SMTP_URL="smtp://[user]:[password]@sandbox.smtp.mailtrap.io:[port]"
• pnpm db:push to push schema to DB
• Cron Jobs
  • Add cron jobs to crons.ts
  • Set isActive to true to activate the cron job
  • Add /api/cron/{cronName} to your app (see test cron) for an example
  • Run pnpm install to sync the cron jobs to vercel.json
  • Add an Environment Variable CRON_SECRET to your app
    • If you use Gitenvs and Vercel you need to set the CRON_SECRET directly in Vercel not in Gitenvs

Run

pnpm install
pnpm dev

Libraries

• Next.js
• Tailwind CSS
• pnpm
• shadcn/ui
• @teampilot/sdk
• drizzle
• Auth.js
• @sodefa/next-server-context
• Vercel AI SDK

Update

You can get the latest changes from the template by running:

git remote add template https://github.com/rechenberger/party-starter.git
git fetch --all
git merge template/main --allow-unrelated-histories

You might have to resolve a few merge conflicts, but that's it!