🌴 Oasis — The Connected Workspace

Oasis is a full-featured Notion clone built on a modern technology stack. It's a unified space for your notes, documents, and ideas — where organizing information is fast, beautiful, and intuitive.

---

✨ Features

Feature	Description
📝 Rich Text Editor	Full support for headings, lists, checkboxes, and real-time formatting
📁 Infinite Nesting	Create documents inside documents — build the perfect hierarchy
☁️ Cloud Storage	Image and icon uploads powered by EdgeStore
🔐 Authentication	Secure sign-in via Clerk (Google, GitHub, and more)
🚀 Real-time Database	Instant sync across all clients via Convex
🌗 Dark Mode	Full light/dark theme support via next-themes
🗑️ Trash & Restore	Soft-delete notes and restore or permanently delete them
📱 Responsive Design	Works great on desktop and mobile

---

🛠 Tech Stack

Layer	Technology
Framework	Next.js 14/15 (App Router)
Database & Backend	Convex (Real-time DB)
Auth	Clerk
Styling	Tailwind CSS
UI Components	Shadcn/UI
File Storage	EdgeStore
Icons	Lucide React

---

🚀 Getting Started

1. Clone the repository

git clone https://github.com/Empty-Developer/Oasis-Web-App
cd oasis

2. Install dependencies

This project uses Bun, but npm or yarn work too:

bun install

3. Configure environment variables

Create a .env.local file in the project root and add your keys:

# Convex
NEXT_PUBLIC_CONVEX_URL=your_convex_url

# Clerk Auth
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key

# EdgeStore
EDGE_STORE_ACCESS_KEY=your_edgestore_access_key
EDGE_STORE_SECRET_KEY=your_edgestore_secret_key

4. Start the Convex backend

In a separate terminal, run Convex in development mode:

npx convex dev

5. Start the frontend

bun dev

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

---

📦 Building & Deployment

This project is optimized for deployment on Vercel:

1. Push your code to GitHub.
2. Import the project into Vercel.
3. Add all environment variables from .env.local to your Vercel project settings.
4. Run npx convex deploy to deploy the Convex backend to production.

---

📄 License

MIT © https://github.com/Empty-Developer