create-feature

Create Feature Module

Scaffold a complete feature module following the project's exact conventions.

Gather Information

Ask the user for:

1. Feature name (e.g., "products", "orders", "notifications") - lowercase, plural
2. Entity fields - the data shape (name, type pairs)
3. API endpoint base (e.g., "/products") - defaults to /<feature-name>

Steps

1. Create Directory Structure

src/features/<name>/
├── types/index.ts
├── services/<name>Service.ts
├── hooks/use<Name>.ts
├── schemas/<name>Schema.ts
├── constants/index.ts
└── components/          (empty directory, ready for feature components)

2. Generate Types File

// src/features/<name>/types/index.ts
export interface <Entity> {
  id: string;
  // ... fields from user input
  createdAt: string;
  updatedAt: string;
}

export interface Create<Entity>Data {
  // ... writable fields (exclude id, createdAt, updatedAt)
}

export interface Update<Entity>Data extends Partial<Create<Entity>Data> {}

3. Generate Service File

// src/features/<name>/services/<name>Service.ts
import { api } from '@/services/api';
import type { <Entity>, Create<Entity>Data, Update<Entity>Data } from '../types';

export async function fetch<Entities>(): Promise<<Entity>[]> {
  const { data } = await api.get<<Entity>[]>('<endpoint>');
  return data;
}

export async function fetch<Entity>(id: string): Promise<<Entity>> {
  const { data } = await api.get<<Entity>>(`<endpoint>/${id}`);
  return data;
}

export async function create<Entity>(payload: Create<Entity>Data): Promise<<Entity>> {
  const { data } = await api.post<<Entity>>('<endpoint>', payload);
  return data;
}

export async function update<Entity>(id: string, payload: Update<Entity>Data): Promise<<Entity>> {
  const { data } = await api.patch<<Entity>>(`<endpoint>/${id}`, payload);
  return data;
}

export async function delete<Entity>(id: string): Promise<void> {
  await api.delete(`<endpoint>/${id}`);
}