Illima Cloud ☁️

Illima Cloud is a high-performance, minimalist cloud workspace designed for rapid thought capture and rich document editing. Re-architected from the ground up using Nuxt 3, it combines server-side optimization, secure authentication, and an extensible editor framework to offer a distraction-free writing environment.

---

✨ Key Features

• 📝 Extensible Rich Text Editor: A distraction-free editing canvas powered by TipTap, supporting bold, italic, strike, underline, code blocks, alignment, auto-linking, image handling, and live character/word count.
• ⚡ Rapid Capture: A dedicated view designed to quickly dump raw thoughts, scratchpads, links, and text captures without losing flow.
• 🔐 Robust Session Security: Integrated authentication with Supabase Auth protected by dynamic Nuxt middleware router guards.
• 🎨 Modern Dark/Glassmorphic UI: Tailored visual system styled with UnoCSS, implementing premium dark-themed color palettes, responsive sidebars, and elegant UI transitions.
• ⚙️ Centralized Database Client Proxy: Seamless Nuxt composition integration. A unique DAO (Data Access Object) design wraps Supabase requests in a dynamic client proxy, maintaining architectural cleanliness.
• 📜 Interactive Changelog: A native, visually polished release timeline highlighting version features and improvements.

---

🛠️ Architecture & Tech Stack

• Framework: Nuxt 3 (Vue 3, TypeScript, Vite)
• Database & Auth: Supabase (PostgreSQL + GoTrue Authentication)
• Styling: UnoCSS (High-performance atomic CSS engine)
• Editor Core: TipTap (Headless rich-text editor framework)
• State & Utilities: VueUse (Reactive composables ecosystem)

---

📁 Project Structure

├── src/
│   ├── business/          # Core business services & data layers
│   │   ├── CaptureDAO.ts   # Data access logic for rapid captures
│   │   ├── DocumentDAO.ts  # Data access logic for workspace documents
│   │   └── ImageService.ts # CDN/Storage operations for images
│   ├── components/        # Reusable UI components & dialogs
│   ├── layouts/           # Page master templates (app vs public)
│   ├── middleware/        # Route guard middlewares (auth.global.ts)
│   ├── pages/             # File-based routing structure
│   │   ├── auth/          # Sign-in & Sign-up views
│   │   ├── app/           # Workspace routes (capture, doc editor, changelog)
│   │   └── index.vue      # Landing page
│   ├── public/            # Static assets and icons
│   ├── db.ts              # Proxy forwarding layer for the Supabase Client
│   └── app.vue            # Root component injecting global styles
├── nuxt.config.ts         # Nuxt framework configuration
├── uno.config.ts          # UnoCSS atomic styles & preset rules
└── package.json           # Project dependencies & run scripts

---

🚀 Getting Started

Prerequisites

Ensure you have pnpm and Node.js (v18+ recommended) installed.

1. Clone the repository and install dependencies

git clone <repository-url>
cd illima-cloud
pnpm install

2. Environment Configuration

Create a .env file in the root directory and append your Supabase credentials:

SUPABASE_URL=https://your-project-id.supabase.co
SUPABASE_KEY=your-supabase-anon-key

3. Start Development Server

Run the local development server:

pnpm dev

Your server will spin up, typically at http://localhost:3000.

4. Build and Preview

For production environments:

# Build the production bundle
pnpm build

# Preview the production build locally
pnpm preview

---

🌐 Deployment

This application is ready for deployment on Vercel out-of-the-box:

1. Connect your GitHub repository to Vercel.
2. Ensure you add SUPABASE_URL and SUPABASE_KEY as Environment Variables in your Vercel project settings.
3. Vercel will automatically detect Nuxt 3 and configure the build settings.

---

📄 License

This project is private and proprietary. All rights reserved.