# Use and adapt developers

Use the documented interfaces and source layout for **developers**. The sections below retain the README’s examples and configuration details.

## Core Architecture

- **DWS (Developer Workspace)** — Main workspace container
- **Chat** — Core unit; every screen is built from it
- **Solid components** — Reusable UI via props
- **Actions** — Shown in chat with confirm/cancel flows

## Project Structure

```
app/                  # Next.js App Router pages
components/
  ag-ui/              # Design system (solid, conformer, motion, skeleton)
  ws/                 # Chat & workspace components
  landing/            # Landing page sections
  profile/            # Profile components
convex/               # Convex functions & schema
hooks/                # React hooks
lib/                  # Utilities & config
docs/                 # Documentation
```

## Commands in the root manifest

The captured [package.json](https://github.com/Up-to-code/developers/blob/HEAD/package.json) declares the following scripts. Run them from the directory containing that manifest.

| Command | Script |
| --- | --- |
| `npm run dev` | `bash -lc 'export TMPDIR=${TMPDIR:-/tmp}; export XDG_CACHE_HOME=${XDG_CACHE_HOME:-$TMPDIR}; export BUN_INSTALL_CACHE_DIR=${BUN_INSTALL_CACHE_DIR:-$TMPDIR/bun}; if [ ! -d node_modules ]; then bun install; fi; bunx --bun next dev --port 3003'` |
| `npm run build` | `bash -lc 'export TMPDIR=${TMPDIR:-/tmp}; export XDG_CACHE_HOME=${XDG_CACHE_HOME:-$TMPDIR}; export BUN_INSTALL_CACHE_DIR=${BUN_INSTALL_CACHE_DIR:-$TMPDIR/bun}; if [ ! -d node_modules ]; then bun install; fi; bunx --bun next build'` |
| `npm run start` | `bash -lc 'export TMPDIR=${TMPDIR:-/tmp}; bunx --bun next start --port 3003'` |
| `npm run lint` | `bash -lc 'export TMPDIR=${TMPDIR:-/tmp}; export XDG_CACHE_HOME=${XDG_CACHE_HOME:-$TMPDIR}; export BUN_INSTALL_CACHE_DIR=${BUN_INSTALL_CACHE_DIR:-$TMPDIR/bun}; if [ ! -d node_modules ]; then bun install; fi; bunx --bun eslint'` |

## Troubleshoot a local change

1. Reproduce the smallest example from the [quick-start guide](/docs/up-to-code-developers/quick-start-guide).
2. Compare required configuration and dependency versions with the README.
3. Check the linked issue tracker for the same error. Include the command, runtime version, and relevant error when reporting a problem; omit credentials.

## Source and help

- [GitHub repository](https://github.com/Up-to-code/developers)
- [Original README](https://github.com/Up-to-code/developers/blob/main/README.md)
- [Issues and existing reports](https://github.com/Up-to-code/developers/issues)