github/sim

mirror of https://github.com/simstudioai/sim.git synced 2026-01-28 00:08:21 -05:00

Files

Emir Karabeg 2daf34386e fix(copilot): ui/ux (#2891 )

* feat(claude): added rules

* fix(copilot): chat loading; refactor(copilot): components, utils, hooks

* fix(copilot): options selection strikethrough

* fix(copilot): options render inside thinking

* fix(copilot): checkpoints, user-input; improvement(code): colors

* fix(copilot): scrolling, tool-call truncation, thinking ui

* fix(copilot): tool call spacing and shimmer/actions on previous messages

* improvement(copilot): queue

* addressed comments

2026-01-19 23:23:21 -08:00

2.0 KiB

Raw Permalink Blame History

paths

apps/sim/**

Sim App Architecture

Core Principles

Single Responsibility: Each component, hook, store has one clear purpose
Composition Over Complexity: Break down complex logic into smaller pieces
Type Safety First: TypeScript interfaces for all props, state, return types
Predictable State: Zustand for global state, useState for UI-only concerns

Root-Level Structure

apps/sim/
├── app/                 # Next.js app router (pages, API routes)
├── blocks/              # Block definitions and registry
├── components/          # Shared UI (emcn/, ui/)
├── executor/            # Workflow execution engine
├── hooks/               # Shared hooks (queries/, selectors/)
├── lib/                 # App-wide utilities
├── providers/           # LLM provider integrations
├── stores/              # Zustand stores
├── tools/               # Tool definitions
└── triggers/            # Trigger definitions

Feature Organization

Features live under app/workspace/[workspaceId]/:

feature/
├── components/          # Feature components
├── hooks/               # Feature-scoped hooks
├── utils/               # Feature-scoped utilities (2+ consumers)
├── feature.tsx          # Main component
└── page.tsx             # Next.js page entry

Naming Conventions

Components: PascalCase (WorkflowList)
Hooks: use prefix (useWorkflowOperations)
Files: kebab-case (workflow-list.tsx)
Stores: stores/feature/store.ts
Constants: SCREAMING_SNAKE_CASE
Interfaces: PascalCase with suffix (WorkflowListProps)

Utils Rules

Never create utils.ts for single consumer - inline it
Create utils.ts when 2+ files need the same helper
Check existing sources before duplicating (lib/ has many utilities)
Location: lib/ (app-wide) → feature/utils/ (feature-scoped) → inline (single-use)

2.0 KiB Raw Permalink Blame History