turbomac  by ljq0226

TypeScript fullstack project simulating a Mac desktop environment

created 2 years ago
301 stars

Top 89.6% on sourcepulse

GitHubView on GitHub
Project Summary

This project simulates a macOS desktop experience using a full-stack TypeScript application, targeting developers interested in modern web technologies and UI/UX design. It offers a rich, interactive environment with features like app launching, a terminal, and real-time chat, showcasing the capabilities of Next.js 13, TurboPack, and other cutting-edge tools.

How It Works

The application leverages a modern stack including Next.js 13 with React Server Components (RSC), Zustand for state management, Tailwind CSS for styling, and Framer Motion for animations. The backend is built with Nest.js and Prisma for data access, utilizing MySQL for the database and Socket.io for real-time communication. TurboRepo manages the monorepo structure, promoting component-based development and clear code organization.

Quick Start & Requirements

  • Install dependencies: npm install or pnpm install in client and server directories.
  • Environment variables: Create .env files in client/ and server/ with API keys (OpenAI), database credentials, and cloud storage configurations (Tencent Cloud COS).
  • Database migration: Run npx prisma migrate dev --name init in the server/ directory.
  • Run the application: Execute npm run dev or pnpm run dev in both client/ and server/ directories, or turbo dev from the root.
  • Prerequisites: Node.js, npm/pnpm, MySQL, OpenAI API Key, Tencent Cloud account (for COS storage).
  • Links: Project GitHub, Juejin Article

Highlighted Details

  • Simulated macOS desktop with features like drag-and-drop windows, app launching, and a functional terminal with command history and tab completion.
  • Integrated TurboChat for real-time messaging with file uploads and scroll loading, including ChatGPT integration via OpenAI API.
  • VSCode integration using github1s for viewing source code within the application.
  • Utilizes TurboPack for potentially faster build times.

Maintenance & Community

The project is maintained by ljq0226. Further community or maintenance details are not explicitly provided in the README.

Licensing & Compatibility

The README does not specify a license. Compatibility for commercial use or closed-source linking is not detailed.

Limitations & Caveats

The project appears to be a demonstration and may not be production-ready. Specific setup for Tencent Cloud COS is required for certain features. The README does not detail testing or deployment strategies beyond basic setup.

Health Check
Last commit

1 year ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
8 stars in the last 90 days

Explore Similar Projects

Starred by Dan Abramov Dan Abramov(Core Contributor to React) and Jared Palmer Jared Palmer(Ex-VP of AI at Vercel; Founder of Turborepo; Author of Formik, TSDX).

retro-board by antoinejaussoin

0.1%
797
AI-powered agile retrospective board for engineering teams
created 9 years ago
updated 8 months ago
Feedback? Help us improve.