https://github.com/educlopez/airlume
A modern AI-powered tool to generate social media posts using smart presets, reusable prompts, and a streamlined interface.
https://github.com/educlopez/airlume
clerk hackathon motion nextjs supabase tailwindcss triggerdev
Last synced: about 1 month ago
JSON representation
A modern AI-powered tool to generate social media posts using smart presets, reusable prompts, and a streamlined interface.
- Host: GitHub
- URL: https://github.com/educlopez/airlume
- Owner: educlopez
- License: other
- Created: 2025-05-10T06:33:08.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-03-20T08:36:19.000Z (about 2 months ago)
- Last Synced: 2026-03-20T11:37:56.196Z (about 2 months ago)
- Topics: clerk, hackathon, motion, nextjs, supabase, tailwindcss, triggerdev
- Language: TypeScript
- Homepage: https://airlume.vercel.app
- Size: 18.9 MB
- Stars: 9
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Airlume
A modern AI-powered tool to generate social media posts using smart presets, reusable prompts, and a streamlined interface.
---
## 🚀 Demo
**Live Demo:** [https://airlume.vercel.app/](https://airlume.vercel.app/)
---
## 🖼️ Screenshots
Landing Demo
Dashboard
AI Generator
Scheduler
Media Library
---
## ✨ Features
- **AI Content Generation:** Generate high-quality social media posts using OpenAI GPT models.
- **Smart Presets & Prompts:** Modular, reusable prompts for different content types and platforms.
- **User Dashboard:** Manage drafts, scheduled posts, and media assets in a streamlined interface.
- **Social Integrations:** Connect and publish directly to Twitter/X and Bluesky.
- **Media Library:** Store and manage images for your posts.
- **CRON Jobs:** Schedule posts to publish at specific times with trigger.dev.
- **Modern UI:** Built with Next.js App Router, Tailwind CSS v4, and Shadcn/UI for a beautiful, responsive experience.
---
## 🔐 Authentication with Clerk
Authentication and user management are handled by [Clerk.dev](https://clerk.dev/docs):
- **Sign Up & Sign In:** Secure, customizable authentication flows.
- **Session Management:** Persistent sessions across devices.
- **User Profiles:** Users can update their profile, email, password, and manage social connections via Clerk's UI.
- **Social Logins:** Easily connect Twitter/X and Bluesky accounts for seamless publishing.
- **Protected Routes:** All user-specific pages (dashboard, generator, media library, etc.) are protected using Clerk middleware.
- **API Security:** All API routes validate the user via Clerk before performing actions.
_Example:_
```tsx
import { ClerkProvider } from "@clerk/nextjs"
export default function RootLayout({ children }) {
return (
{/* ... */}
{children}
)
}
```
---
## 🛠️ Tech Stack
- **Frontend:** Next.js (App Router), Tailwind CSS v4, Shadcn/UI
- **Backend:** Supabase (Edge Functions)
- **Authentication:** Clerk.dev
- **AI Integration:** OpenAI GPT models via Vercel AI SDK
- **CRON Jobs:** Trigger.dev
- **Package Manager:** pnpm
---
## 📦 Real Project Structure
```
/
├── public/
│ ├── images/
│ │ └── bg-stripe.png
│ └── opengraph-image.jpg
├── src/
│ ├── app/
│ │ ├── [username]/
│ │ │ ├── generator/
│ │ │ ├── media-library/
│ │ │ ├── posts/
│ │ │ ├── settings/
│ │ │ ├── layout.tsx
│ │ │ └── page.tsx
│ │ ├── api/
│ │ ├── globals.css
│ │ ├── layout.tsx
│ │ ├── page.tsx
│ │ ├── robots.ts
│ │ └── sitemap.ts
│ ├── assets/
│ │ └── images/
│ ├── components/
│ │ ├── landing/
│ │ ├── icons/
│ │ ├── ui/
│ │ ├── app-sidebar.tsx
│ │ ├── copyright.tsx
│ │ ├── dashboard-greeting.tsx
│ │ ├── dashboard-header-gradient.tsx
│ │ ├── logo.tsx
│ │ ├── nav-generations.tsx
│ │ ├── nav-main.tsx
│ │ ├── nav-user.tsx
│ │ ├── site-header.tsx
│ │ ├── theme-switcher.tsx
│ │ └── user-profile-dialog.tsx
│ ├── hooks/
│ │ └── use-mobile.ts
│ ├── lib/
│ │ ├── database.types.ts
│ │ ├── supabaseAdmin.ts
│ │ ├── supabaseClient.ts
│ │ └── utils.ts
│ ├── trigger/
│ │ ├── scheduledPost.ts
│ │ └── .gitkeep
│ ├── middleware.ts
│ └── trigger.ts
├── README.md
└── package.json
```
---
## 🧪 Development
- **Install dependencies:** `pnpm install`
- **Run dev server:** `pnpm dev`
- **Build:** `pnpm build`
- **Lint:** `pnpm lint`
---
## 📝 References
- [Supabase Documentation](https://supabase.com/docs)
- [Clerk Documentation](https://clerk.dev/docs)
- [Shadcn/UI Components](https://ui.shadcn.com/docs)
- [Vercel AI SDK](https://ai-sdk.dev/docs/)
- [OpenAI API Reference](https://platform.openai.com/docs)
---
## 📄 License
Business Source License (see LICENSE file for details)