mirror of
https://github.com/muchq/muchq.github.io.git
synced 2026-06-11 11:45:03 +00:00
No description
https://muchq.com/
- TypeScript 74.4%
- CSS 25.3%
- HTML 0.2%
5bf2b47658* Update react 19.2.5, vite 8, eslint 10, and @vitejs/plugin-react 6 - Bump react and react-dom to 19.2.5 - Bump vite to 8.0.8 and @vitejs/plugin-react to 6.0.1 - Bump eslint to 10.2.0 and @eslint/js to 10.0.1 - Use eslint-plugin-react-hooks canary for eslint 10 peer support - Convert manualChunks to function form for Rolldown (vite 8) - Disable new canary-only lint rules to keep update non-breaking * Address react-hooks/set-state-in-effect lint rule Convert useEffect+setState patterns to useMemo for derived state in math-learning components. Move animation end-state transitions into timer callbacks. Add targeted inline suppressions for golf permalink state machine effects where setState coordinates with network calls. Also disable new canary-only lint rules (purity, refs) that flag pre-existing patterns unrelated to this update. |
||
|---|---|---|
| .github | ||
| public | ||
| src | ||
| .gitignore | ||
| CNAME | ||
| eslint.config.js | ||
| GOLF.md | ||
| index.html | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| THOUGHTS.md | ||
| tsconfig.json | ||
| tsconfig.node.json | ||
| vite.config.ts | ||
| vitest.config.ts | ||
| wrangler.json | ||
MuchQ
Just some doodles and a pretty chill game.
🚀 Quick Start
Development
# Install dependencies
npm install
# Start development server
npm run dev
# Open http://localhost:3000
Building
# Type check
npm run typecheck
# Lint code
npm run lint
# Run tests
npm run test
# Build for production
npm run build
# Preview production build
npm run preview
🏗️ Project Structure
src/
├── components/ # React components
│ ├── Navigation.tsx # Main navigation
│ ├── JuliaSetBackground.tsx # WebGL Julia set renderer
│ ├── MathAnimations.tsx # Floating math equations
│ ├── ThoughtsGame.tsx # 3D thoughts game
│ ├── ThoughtsNavigation.tsx # Thoughts page navigation
│ ├── GolfGame.tsx # Golf game component
│ ├── GolfNavigation.tsx # Golf page navigation
│ ├── GroupsNavigation.tsx # Groups page navigation
│ ├── PermutationVisualizer.tsx # Interactive permutation tool
│ ├── CycleDecomposer.tsx # Cycle decomposition calculator
│ ├── PermutationQuiz.tsx # Interactive quiz component
│ ├── SignCalculator.tsx # Permutation sign calculator
│ └── __tests__/ # Component tests
├── hooks/ # Custom React hooks
│ ├── useWebGL.ts # WebGL Julia set logic
│ ├── useThoughtsGame.ts # Thoughts game engine logic
│ └── useGolfGame.ts # Golf game engine logic
├── pages/ # Page components
│ ├── HomePage.tsx # Landing page
│ ├── ThoughtsPage.tsx # Thoughts game page
│ ├── GolfPage.tsx # Golf game page
│ └── GroupsPage.tsx # Permutation groups learning module
├── types/ # TypeScript type definitions
│ ├── game.ts # Game-related types
│ └── vite-env.d.ts # Vite environment types
├── utils/ # Utility functions
│ └── gameUtils.ts # Game helper functions
└── test/ # Test configuration
└── setup.ts # Test setup
🧪 Testing
# Run tests in watch mode
npm run test
# Run tests with UI
npm run test:ui
# Run tests once
npm run test -- --run
📝 Original Migration
Old time-y implementation is preserved in the backup/ directory.
Documentation
- Thoughts Multiplayer API - WebSocket API specification for the multiplayer game environment