solid-agents-project-scaffolder

solid-agents-project-scaffolder

Quick Reference

Project Type Decision Tree

Need a new SolidJS project?
├── Need SSR, file-based routing, server functions, or API routes?
│   └── YES → SolidStart scaffold
│       ├── Full-stack app with data loading? → SolidStart with query/action
│       ├── Static site with prerendering? → SolidStart with SSG preset
│       └── API backend + frontend? → SolidStart with API routes
└── NO → Plain SolidJS scaffold (client-side SPA)
    ├── Simple reactive UI? → Plain SolidJS + Vite
    ├── Need routing? → Plain SolidJS + @solidjs/router
    └── Embedded widget or library? → Plain SolidJS minimal

Critical Warnings

NEVER use create-react-app, next, or any React scaffolding tool for a SolidJS project. The generated configuration, babel presets, and JSX transform are incompatible.

NEVER omit vite-plugin-solid from vite.config.ts. Without it, JSX compilation fails silently or produces React output.

ALWAYS set "jsxImportSource": "solid-js" in tsconfig.json. Without this, TypeScript resolves JSX types from React, causing type errors on SolidJS-specific attributes.

ALWAYS use babel-preset-solid (included via vite-plugin-solid). This preset compiles JSX into SolidJS's fine-grained reactive DOM operations instead of React.createElement calls.

NEVER include react, react-dom, @types/react, or @types/react-dom in dependencies. Their presence causes type conflicts and import confusion.

ALWAYS use solid-js/web for render and hydrate — these are NOT imported from solid-js directly.

---

Plain SolidJS Scaffold (Client-Side SPA)

Required Dependencies

Package	Type	Purpose
solid-js	dependency	Core reactive framework
@solidjs/router	dependency	Client-side routing (if needed)
typescript	devDependency	TypeScript compiler
vite	devDependency	Build tool and dev server
vite-plugin-solid	devDependency	Vite integration for SolidJS JSX compilation
vitest	devDependency	Testing framework
@solidjs/testing-library	devDependency	Component testing utilities
jsdom	devDependency	DOM environment for tests