Skip to content

spaceofnova/linux-react

Repository files navigation

Linux React

A web-based Linux distribution built with React, offering a modern desktop experience in your browser.

Overview

Linux React is an experimental project that brings the Linux desktop experience to the web. It combines the power of Linux with the flexibility of web technologies to create a unique, accessible computing platform.

Core Components

  • 🖥️ Desktop Environment: A React-based desktop interface with window management and system controls
  • 🚀 System Installer: Modern installation wizard for system setup and configuration
  • 📦 Package Management: Web-based application installation and management
  • 💾 Virtual Filesystem: Browser-based filesystem implementation
  • 🔧 System Settings: Comprehensive system configuration interface

Project Structure

  • /installer - System installation wizard
  • /desktop - Main desktop environment
  • /apps - Core system applications
  • /system - System utilities and services
  • /shared - Shared components and utilities
  • /docs - Documentation (WIP)

Technology Stack

  • Frontend: React, TypeScript, TailwindCSS
  • State Management: Zustand
  • Storage: IndexedDB, LocalStorage
  • Package Management: Custom package format and manager

Development Status

⚠️ This project is currently in early development. Many features are experimental and subject to change.

Current Focus

  • [-] Core system architecture
  • Installation wizard
  • Basic desktop environment
  • Application framework
  • Package management system

Getting Started

  1. Clone the repository
  2. Install dependencies with npm install
  3. Start the development environment with npm run dev

Contributing

We welcome contributions! Please check our Contributing Guide for details on:

  • Development setup
  • Code style guidelines
  • Pull request process
  • Feature proposals

Documentation

Community

License

This project is licensed under MIT

Acknowledgments

  • The Linux community
  • React development team
  • All our contributors
  • My friend Kai for tons of help and support