Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions packages/cli/templates/.agents/rules/workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,12 @@ cover what you need, the full hosted docs are at **https://docs.webjs.com**.
the example `User` model, the example users module, etc. with the app the
user actually asked for. Do not ship "Hello from <app-name>" as the
deliverable.
- **Use a unique design (UI apps).** When the app has a UI, give it a design of
your own (palette, layout, typography, chrome) that fits what the user asked
for. Do NOT mimic the scaffold's example look (its warm colors, the 760px
reading column, the example header/nav). The `api` template has no UI, so this
Comment thread
vivek7405 marked this conversation as resolved.
does not apply there. Keep the design tokens and theme setup in
`app/layout.ts`, those are infrastructure, and restyle on top of them.
- **Only three templates exist:** `webjs create <name>` (default full-stack),
`--template api`, `--template saas`. The CLI rejects any other `--template`
value. Pick:
Expand Down
7 changes: 7 additions & 0 deletions packages/cli/templates/.cursorrules
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,13 @@ cover what you need, the full hosted docs are at **https://docs.webjs.com**.
`app/page.ts`, the example `User` model, the example users module, etc.
with the app the user actually asked for. Don't ship "Hello from
<app-name>" as the deliverable.
- **Use a unique design (UI apps).** When the app has a UI, give it a
design of your own (palette, layout, typography, chrome) that fits what
the user asked for. Do NOT mimic the scaffold's example look (its warm
colors, the 760px reading column, the example header/nav). The `api`
template has no UI, so this does not apply there. Keep the design tokens
Comment thread
vivek7405 marked this conversation as resolved.
and theme setup in `app/layout.ts`, those are infrastructure, and
restyle on top of them.
- **Only three templates exist:** `webjs create <name>` (default
full-stack), `--template api`, `--template saas`. The CLI rejects any
other `--template` value. Pick:
Expand Down
7 changes: 7 additions & 0 deletions packages/cli/templates/.github/copilot-instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,13 @@ the full hosted docs are at **https://docs.webjs.com**.
`app/page.ts`, the example `User` model, the example users module, etc.
with the app the user actually asked for. Don't ship "Hello from
<app-name>" as the deliverable.
- **Use a unique design (UI apps).** When the app has a UI, give it a
design of your own (palette, layout, typography, chrome) that fits what
the user asked for. Do NOT mimic the scaffold's example look (its warm
colors, the 760px reading column, the example header/nav). The `api`
template has no UI, so this does not apply there. Keep the design tokens
Comment thread
vivek7405 marked this conversation as resolved.
and theme setup in `app/layout.ts`, those are infrastructure, and
restyle on top of them.
- **Only three templates exist:** `webjs create <name>` (default
full-stack), `--template api`, `--template saas`. The CLI rejects any
other `--template` value. Pick:
Expand Down
8 changes: 7 additions & 1 deletion packages/cli/templates/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,13 @@ example `Home` nav, and pick a content-width container that fits. The
default `<main class="max-w-[760px]">` is a reading column for prose and
forms, so for a full-bleed app, dashboard, or board, widen the cap or
remove it (keep the theme tokens). A wide layout left in the 760px
reading column overflows into a horizontal scrollbar. This is ENFORCED:
reading column overflows into a horizontal scrollbar. **Give the app a
unique design.** When it has a UI, choose its palette, layout, typography,
and chrome to fit what the user asked for, rather than mimicking the
scaffold's example look (the warm accent, the reading column, the serif
display, the example header/nav) or just recoloring the same layout. The
`api` template has no UI, so this does not apply there. The design tokens
and theme wiring are infrastructure to keep and restyle on top of. This is ENFORCED:
the example `app/page.ts` and `app/layout.ts` carry a
`webjs-scaffold-placeholder` marker comment, and `webjs check` fails
while any marker remains, so this freshly scaffolded app fails the check
Expand Down
10 changes: 9 additions & 1 deletion packages/cli/templates/CONVENTIONS.md
Original file line number Diff line number Diff line change
Expand Up @@ -333,7 +333,15 @@ When the user asks the agent to build their actual app:
dashboard, or board, or a wide layout overflows into an unnecessary
horizontal scrollbar. Keep the design tokens and theme setup, those
are infrastructure.
6. **Keep:** the Drizzle setup, the test config, the agent config files
6. **Use a unique design (UI apps).** Give the app a look of its own that
fits what the user asked for. Choose the palette, layout, typography,
spacing, and chrome deliberately. Do NOT mimic the scaffold's example
look (its warm accent, the 760px reading column, the serif display, the
example header/nav), and do not just recolor the same layout. The
`api` template has no UI, so this does not apply there. The design
tokens and theme wiring in `app/layout.ts` are infrastructure to keep
and restyle on top of, not the example look to preserve.
7. **Keep:** the Drizzle setup, the test config, the agent config files
(`AGENTS.md`, `CONVENTIONS.md`, `CLAUDE.md`, `.cursorrules`, etc.),
`db/connection.server.ts` + `db/columns.server.ts`, the directory
conventions, the design tokens in `app/layout.ts`. These are the
Expand Down
Loading