# Use and adapt dashboard-ui-initializer

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

## Local Development

From the repository root:

```bash
npm run dev:workspace
```

From this app folder:

```bash
npm run dev
```

Default local URL: `http://localhost:3000`.

The dev script starts Next.js and Convex together. Use
`npm run dev:next` or `npm run dev:convex` when debugging only one side.

## Commands in the root manifest

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

| Command | Script |
| --- | --- |
| `npm run dev` | `next dev` |
| `npm run build` | `next build && node scripts/ensure-vercel-manifest.mjs` |
| `npm run start` | `next start` |
| `npm run typecheck` | `tsc --noEmit` |
| `npm run lint` | `eslint` |
| `npm run test` | `vitest run` |

## Troubleshoot a local change

1. Reproduce the smallest example from the [quick-start guide](/docs/up-to-code-dashboard-ui-initializer/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/dashboard-ui-initializer)
- [Original README](https://github.com/Up-to-code/dashboard-ui-initializer/blob/main/README.md)
- [Issues and existing reports](https://github.com/Up-to-code/dashboard-ui-initializer/issues)