File size: 2,953 Bytes
ceb943f
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
6be128e
 
 
6c576f2
6be128e
ceb943f
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
---
title: Vault Video Processor
emoji: πŸ“Ή
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false
app_port: 7860
---

# Vault

Vault is an AI-powered platform that transforms YouTube video archives into shoppable experiences. Creators can monetize their existing content by automatically detecting products featured in videos and matching them to marketplace listings.

## Project Overview

**Tech Stack:**
- **Framework**: Next.js 15 (App Router) with TypeScript
- **Styling**: Tailwind CSS v4 with dark theme
- **Database**: Supabase Postgres with Drizzle ORM
- **Authentication**: Better Auth with YouTube OAuth
- **Background Jobs**: Inngest for AI discovery pipeline
- **Deployment**: Vercel (Frontend) + Railway (Workers)

## Troubleshooting

For detailed information about cloud deployment issues and solutions, see the [Troubleshooting Guide](src/features/discovery/docs/troubleshooting.md).
For a comprehensive architectural overview of our cloud extraction strategy, see the [Cloud Extraction Guide](src/features/discovery/docs/cloud_extraction_implementation_guide.md).

## Getting Started

### Prerequisites

- Node.js 20+ installed
- npm or yarn package manager

### Installation

1. Clone the repository
2. Install dependencies:
   ```bash
   npm install
   ```

3. Copy environment variables:
   ```bash
   cp .env.example .env.local
   ```

4. Run the development server:
   ```bash
   npm run dev
   ```

5. Open [http://localhost:3000](http://localhost:3000) to see the application.

## Available Scripts

- `npm run dev` - Start development server with Turbopack
- `npm run build` - Build production application
- `npm run start` - Start production server
- `npm run lint` - Run ESLint code quality checks

## Project Structure

```
vault/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/              # Next.js 15 App Router pages
β”‚   β”œβ”€β”€ components/       # Shared UI components
β”‚   β”œβ”€β”€ features/         # Feature-based modules
β”‚   β”‚   β”œβ”€β”€ auth/         # Authentication
β”‚   β”‚   β”œβ”€β”€ discovery/    # AI scanning
β”‚   β”‚   β”œβ”€β”€ marketplace/  # Marketplace sync
β”‚   β”‚   β”œβ”€β”€ vault/        # Viewer experience
β”‚   β”‚   └── dashboard/    # Creator dashboard
β”‚   β”œβ”€β”€ lib/              # Utilities and configs
β”‚   └── types/            # TypeScript types
β”œβ”€β”€ public/               # Static assets
└── [config files]
```

## Architecture

This project follows a feature-based architecture with:
- **Mobile-first design** (375px, 768px, 1200px breakpoints)
- **Dark theme** (#0A0B14 backgrounds, #4169FF primary actions)
- **Server-side rendering** for SEO optimization
- **Inngest workflows** for long-running AI tasks

## Learn More

- [Next.js Documentation](https://nextjs.org/docs)
- [Tailwind CSS](https://tailwindcss.com/docs)
- [Supabase](https://supabase.com/docs)
- [Inngest](https://www.inngest.com/docs)

## License

Private - All Rights Reserved