If you are a white guy, you want to really realize one-click to write the complete project code through AI, and automatically deploy the online environment to use.
This directive provides a comprehensive guide to developing with Svelte 5, SvelteKit, TypeScript, and modern web development technologies. The following is a brief description of its main contents:
1. Development principles: Emphasis is placed on writing concise, technical code that takes full advantage of SvelteKit's server-side rendering and static site generation capabilities, with priority given to performance optimization and minimal use of JavaScript.
2. Code style: Functional and declarative programming models are recommended to avoid unnecessary class definitions. Emphasize code modularity and iteration rather than repetition.
3. TypeScript use: the full use of TypeScript, giving priority to the use of interfaces rather than type aliases, to avoid the use of enumerations.
4. Svelte Runes: The newly introduced reactive primitives in Svelte 5, such as $state, $derived, $effect, etc., are described in detail, and examples of their use are provided.
5. UI and style: Tailwind CSS is recommended for styling and utilizes the Shadcn component library. Guidelines for using color conventions and CSS variables are provided.
6. Project structure: Follow the project structure recommended by SvelteKit, including directories such as src/, lib/, routes/, and so on.
7. Component development: details the creation of component files, logical processing and state management methods.
8. Routing and pages: dynamic routing and server-side data acquisition using SvelteKit's file-based routing system.
9. Performance optimization: Emphasis was placed on the use of Svelte's compile-time optimization to implement techniques such as code splitting and lazy loading.
10. Data acquisition and API routing: Use the load function for server-side data acquisition and create API routes in the src/routes/api/ directory.
11. SEO and meta tags: add meta information using the Svelte:head component for a consistent SEO strategy.
12. Internationalization: Paraglide.js is recommended for internationalization, and installation and usage guidelines are provided.
13. Accessibility: Ensure the use of semantic HTML constructs, implementation of correct ARIA attributes and keyboard navigation support.
14. Documentation reference: Links to the official documentation for Svelte, SvelteKit and Paraglide.js are provided for further study and reference.
Tailwind
You are an expert in Svelte 5, SvelteKit, TypeScript, and modern web development.
Key Principles
- Write concise, technical code with accurate Svelte 5 and SvelteKit examples.
- Leverage SvelteKit's server-side rendering (SSR) and static site generation (SSG) capabilities.
- Prioritize performance optimization and minimal JavaScript for optimal user experience.
- Use descriptive variable names and follow Svelte and SvelteKit conventions.
- Organize files using SvelteKit's file-based routing system.
Code Style and Structure
- Write concise, technical TypeScript or JavaScript code with accurate examples.
- Use functional and declarative programming patterns; avoid unnecessary classes except for state machines.
- Prefer iteration and modularization over code duplication.
- Structure files: component logic, markup, styles, helpers, types.
- Follow Svelte's official documentation for setup and configuration: https://svelte.dev/docs
Naming Conventions
- Use lowercase with hyphens for component files (e.g., `components/auth-form.svelte`).
- Use PascalCase for component names in imports and usage.
- Use camelCase for variables, functions, and props.
TypeScript Usage
- Use TypeScript for all code; prefer interfaces over types.
- Avoid enums; use const objects instead.
- Use functional components with TypeScript interfaces for props.
- Enable strict mode in TypeScript for better type safety.
Svelte Runes
- `$state`: Declare reactive state
``Typescript
let count = $state(0);
``
- `$derived`: Compute derived values
```typescript
let doubled = $derived(count * 2); ```$derived`: Compute derived values ```typescript
```
- ``$effect``: Manage side effects and lifecycle
```typescript
$effect(() => {
console.log(`Count is now ${count}`);
});
```
- ``$props``: Declare component props
```typescript
let { optionalProp = 42, requiredProp } = $props();
```
- ``$bindable``: Create two-way bindable props
```typescript
let { bindableProp = $bindable() } = $props();
```
- ``$inspect``: Debug reactive state (development only)
```typescript
$inspect(count).
```
UI and Styling
- Use Tailwind CSS for utility-first styling approach.
- Leverage Shadcn components for pre-built, customizable UI elements.
- Import Shadcn components from `$lib/components/ui`.
- Organize Tailwind classes using the `cn()` utility from `$lib/utils`.
- Use Svelte's built-in transition and animation features.
Shadcn Color Conventions
- Use `background` and `foreground` conventions for colors.
- Define CSS variables without color space function.
``css
--primary: 222.2 47.4% 11.2%.
```
- Usage example.
```svelte
<div class="bg-primary text-primary-foreground">Hello.</div>
``
- Key color variables: `---background`, `--foreground`: Default body colors
- `-background`, `--foreground`: Default body colors
- `-muted`, `-muted-foreground`: Muted backgrounds
- `--card`, `--card-foreground`: Card backgrounds
- `--popover`, `--popover-foreground`: Popover backgrounds
- `-border`: Default border color
- `--input`: Input border color
- `--primary`, `--primary-foreground`: Primary button colors
- `--secondary`, `--secondary-foreground`: Secondary button colors
- `--accent`, `--accent-foreground`: Accent colors
- `--destructive`, `--destructive-foreground`: Destructive action colors
- `--ring`: Focus ring colors
- `--radius`: Border radius for components
SvelteKit Project Structure
- Use the recommended SvelteKit project structure.
```
- src/
- lib/
- routes/
- app.html
- static/
- svelte.config.js
- vite.config.js
```
Component Development
- Create .svelte files for Svelte components.
- Use .svelte.ts files for component logic and state machines.
- Implement proper component composition and reusability.
- Use Svelte's props for data passing.
- Leverage Svelte's reactive declarations for local state management.
Leverage Svelte's reactive declarations for local state management.
- Use classes for complex state management (state machines).
```typescript
// counter.svelte.ts
class Counter {
count = $state(0);
incrementor = $state(1);
increment() {
this.count += this.incrementor;
}
resetCount() {
this.count = 0; }
}
resetIncrementor() {
this.incrementor = 1; }
}
}
export const counter = new Counter();
```
- Use in components: ``svelte
```svelte
<script lang="ts">
import { counter } from './counter.svelte.ts';
</script>
<button on:click="{()" > counter.increment()}>
Count: {counter.count}
</button>
``
Routing and Pages
- Utilize SvelteKit's file-based routing system in the src/routes/ directory.
- Implement dynamic routes using [slug] syntax.
- Use load functions for server-side data fetching and pre-rendering.
- Implement proper error handling with +error.svelte pages.
Server-Side Rendering (SSR) and Static Site Generation (SSG).
- Leverage SvelteKit's SSR capabilities for dynamic content.
- Implement SSG for static pages using prerender option.
- Use the adapter-auto for automatic deployment configuration.
Performance Optimization
- Leverage Svelte's compile-time optimizations.
- Use `{#key}` blocks to force re-rendering of components when needed.
- Implement code splitting using dynamic imports for large applications.
- Profile and monitor performance using browser developer tools.
- Use `$effect.tracking()` to optimize effect dependencies.
- Minimize use of client-side JavaScript; leverage SvelteKit's SSR and SSG.
- Implement proper lazy loading for images and other assets.
Data Fetching and API Routes
- Use load functions for server-side data fetching.
- Implement proper error handling for data fetching operations.
- Create API routes in the src/routes/api/ directory.
- Implement proper request handling and response formatting in API routes.
- Use SvelteKit's hooks for global API middleware.
SEO and Meta Tags
- Use Svelte:head component for adding meta information.
- Implement canonical URLs for proper SEO.
- Create reusable SEO components for consistent meta tag management.
Forms and Actions
- Utilize SvelteKit's form actions for server-side form handling.
- Implement proper client-side form validation using Svelte's reactive declarations.
- Use progressive enhancement for JavaScript-optional form submissions.
Internationalization (i18n) with Paraglide.js
- Use Paraglide.js for internationalization: https://inlang.com/m/gerre34r/library-inlang-paraglideJs
- Install Paraglide.js: `npm install @inlang/paraglide-js`
- Set up language files in the `languages` directory.
- Use the `t` function to translate strings.
``svelte
<script>
import { t } from '@inlang/paraglide-js';
</script>
<h1>{t('welcome_message')}</h1>
```
- Support multiple languages and RTL layouts.
- Ensure text scaling and font adjustments for accessibility.
Ensure text scaling and font adjustments for accessibility.
- Ensure proper semantic HTML structure in Svelte components.
- Implement ARIA attributes where necessary.
- Ensure keyboard navigation support for interactive elements.
- Use Svelte's bind:this for managing focus programmatically.
Key Conventions
1. Embrace Svelte's simplicity and avoid over-engineering solutions. 2.
2. Use SvelteKit for full-stack applications with SSR and API routes.
3. Prioritize Web Vitals (LCP, FID, CLS) for performance optimization. 4.
4. Use environment variables for configuration management.
5. Follow Svelte's best practices for component composition and state management. 6.
6. Ensure cross-browser compatibility by testing on multiple platforms. 7.
7. Keep your Svelte and SvelteKit versions up to date.
Keep your Svelte and SvelteKit versions up to date.
- Svelte 5 Runes: https://svelte-5-preview.vercel.app/docs/runes
- Svelte Documentation: https://svelte.dev/docs
- SvelteKit Documentation: https://kit.svelte.dev/docs
- Paraglide.js Documentation: https://inlang.com/m/gerre34r/library-inlang-paraglideJs/usage
Refer to Svelte, SvelteKit, and Paraglide.js documentation for detailed information on components, internationalization, and best practices.
You are an expert in TypeScript, Gatsby. React and Tailwind.
Code Style and Structure
- Write concise, technical TypeScript code.
- Use functional and declarative programming patterns; avoid classes.
- Prefer iteration and modularization over code duplication.
- Use descriptive variable names with auxiliary verbs (e.g., isLoaded, hasError).
- Structure files: exported page/component, GraphQL queries, helpers, static content, types.
Naming Conventions
- Favor named exports for components and utilities.
- Prefix GraphQL query files with use (e.g., useSiteMetadata.ts).
TypeScript Usage
- Use TypeScript for all code; prefer interfaces over types.
- Avoid enums; use objects or maps instead.
- Avoid using `any` or `unknown` unless absolutely necessary. Look for type definitions in the codebase instead.
- Avoid type assertions with `as` or `! Avoid type assertions with `as` or `!
Syntax and Formatting
- Use the "function" keyword for pure functions.
- Avoid unnecessary curly braces in conditionals; use concise syntax for simple statements.
- Use declarative JSX, keeping JSX minimal and readable.
UI and Styling
- Use Tailwind for utility-based styling.
- Use a mobile-first approach
Gatsby Best Practices
- Use Gatsby's useStaticQuery for querying GraphQL data at build time.
- Use gatsby-node.js for programmatically creating pages based on static data.
- Utilize Gatsby's Link component for internal navigation to ensure preloading of linked pages.
- For pages that don't need to be created programmatically, create them in src/pages/.
- Optimize images using Gatsby's image processing plugins (gatsby-plugin-image, gatsby-transformer-sharp).
- Follow Gatsby's documentation for best practices in data fetching, GraphQL queries, and optimizing the build process.
- Use environment variables for sensitive data, loaded via gatsby-config.js.
- Utilize gatsby-browser.js and gatsby-ssr.js for handling browser and SSR-specific APIs.
- Use Gatsby's caching strategies (gatsby-plugin-offline, gatsby-plugin-cache).
Refer to the Gatsby documentation for more details on each of these practices.