Skip to content

atilafassina/crudy

Repository files navigation

Crudy

A Postman-like API testing tool built with Solid.js and SolidStart.

Features

  • Execute HTTP requests
  • Manage request collections
  • Custom headers and request body support
  • Response viewer with formatting and metadata
  • Request history tracking
  • JSON body normalization (handles trailing commas, unquoted keys, single quotes)

Tech Stack

Getting Started

Prerequisites

  • Node.js 22+
  • pnpm

Installation

# Install dependencies
pnpm install

# Start development server (creates .env and seeds database automatically)
pnpm dev

Open http://localhost:3000 to use the app.

Scripts

Command Description
pnpm dev Start development server
pnpm build Build for production
pnpm preview Preview production build
pnpm test Run tests in watch mode
pnpm test:ci Run tests with coverage
pnpm lint Run ESLint

Project Structure

src/
├── components/
│   ├── ui/                 # Reusable UI components (Kobalte-based)
│   ├── api-tester.tsx      # Main app orchestrator
│   ├── request-builder.tsx # Request form (method, URL, headers, body)
│   ├── response-viewer.tsx # Response display
│   └── sidebar.tsx         # Collections and requests navigation
├── lib/
│   ├── client-request.ts   # Client-side HTTP execution
│   ├── normalize-json.ts   # JSON parsing utilities
│   ├── db.ts               # Database types
│   ├── db-client.ts        # Neon SQL client
│   └── server/             # Server-side functions ("use server")
│       ├── requests.ts     # Request CRUD
│       ├── collections.ts  # Collection management
│       └── proxy.ts        # Server-side request proxy
├── routes/
│   └── index.tsx           # Home route
└── test/
    └── setup.ts            # Vitest configuration

Database Schema

  • collections - Groups of saved requests
  • requests - Saved API requests (method, URL, headers, body)
  • request_history - Execution logs with response data

See seed.sql for the full schema.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors