A modern monorepo containing a desktop Electron application, landing page, and web SaaS platform built with TypeScript, React, and Next.js.

This monorepo contains three main applications:

apps/
├── desktop/ # Electron desktop application
├── landing/ # Marketing landing page (Next.js)
└── web/ # Main SaaS web application (Next.js)

• Node.js >= 18.0.0
• Bun >= 1.2.14 (recommended package manager)
• Git

1. Clone the repository

   git clone <repository-url>
   cd singularity-desktop

2. Install dependencies

   bun install

3. Set up environment variables

   Copy the example environment files and configure them:

   # For web app
   cp apps/web/.env.example apps/web/.env.local
   # For landing page
   cp apps/landing/.env.example apps/landing/.env.local

   Configure the following environment variables:

   • CLERK_SECRET_KEY
   • MONGODB_URI
   • NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY
   • NEXT_PUBLIC_CLERK_SIGN_IN_URL

Start all applications in development mode:

bun run dev

This will start:

• Desktop app: Electron application with hot reload
• Landing page: Next.js dev server on http://localhost:3000
• Web app: Next.js dev server on http://localhost:3001

cd apps/desktop
bun run dev

Available scripts:

• bun run dev - Start development with file watching
• bun run dev:nowatch - Start development without file watching
• bun run build - Build the application
• bun run build:win - Build for Windows
• bun run build:mac - Build for macOS
• bun run build:linux - Build for Linux

cd apps/landing
bun run dev

Available scripts:

• bun run dev - Start development server
• bun run build - Build for production
• bun run start - Start production server
• bun run preview - Preview with OpenNext Cloudflare
• bun run deploy - Deploy to Cloudflare

cd apps/web
bun run dev

Available scripts:

• bun run dev - Start development server
• bun run build - Build for production
• bun run start - Start production server
• bun run test - Run tests
• bun run test:e2e - Run end-to-end tests
• bun run db:generate - Generate database migrations
• bun run db:migrate - Run database migrations
• bun run db:studio - Open database studio

bun run build

# Desktop app
cd apps/desktop && bun run build
# Landing page
cd apps/landing && bun run build
# Web app
cd apps/web && bun run build

bun run test

cd apps/web
bun run test # Unit tests
bun run test:e2e # End-to-end tests

bun run lint # Lint all applications
bun run lint:fix # Fix linting issues

bun run check-types # Check TypeScript types

bun run format # Format code with Prettier

• Electron - Cross-platform desktop app framework
• Electron Vite - Build tooling
• React - UI framework
• TypeScript - Type safety
• Tailwind CSS - Styling
• Radix UI - UI components

• Next.js 15 - React framework
• TypeScript - Type safety
• Tailwind CSS - Styling
• Framer Motion - Animations
• Lottie - Interactive animations
• OpenNext Cloudflare - Deployment platform

• Next.js 15 - React framework
• TypeScript - Type safety
• Clerk - Authentication
• Drizzle ORM - Database ORM
• Tailwind CSS - Styling
• Vitest - Testing framework
• Playwright - E2E testing
• Storybook - Component documentation

cd apps/landing
bun run deploy

Build platform-specific distributables:

cd apps/desktop
bun run build:win # Windows
bun run build:mac # macOS
bun run build:linux # Linux

Build and deploy to your preferred hosting platform:

cd apps/web
bun run build

• Turbo - Monorepo build system
• ESLint - Code linting
• Prettier - Code formatting
• TypeScript - Type checking
• Husky - Git hooks
• Commitizen - Conventional commits

• Turborepo Documentation
• Electron Documentation
• Next.js Documentation
• Bun Documentation

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.