Claude-generated alpha starter

Test User Alpha

A lightweight starter for validating your Next.js deployment pipeline

A minimal starter application demonstrating core Next.js 15 patterns with a simple user management API surface for testing and validation purposes.

View Users View project contract

Feature

User Directory

Browse and search test users in a responsive list view

Feature

Quick Add

Create new test users via a simple form interface

Feature

REST API

Clean API endpoints for programmatic user management

Feature

Zero Config Deploy

Ready for Vercel deployment with no external dependencies

Architecture

Next.js 15 App Router application with TypeScript.
Server Components for static pages, Client Components for interactive elements.
Route Handlers in /api for RESTful endpoints.
In-memory data store for alpha (no external database dependency).
Tailwind CSS for styling.
Deployed as serverless functions on Vercel.

Core components

Landing page with hero sectionUser list display componentUser creation formAPI route handlers for CRUD operationsIn-memory data store utility

Timeline

Foundation

Project scaffolding, layout, and landing page

Data Layer

In-memory store and TypeScript interfaces

API Surface

Route handlers for user CRUD operations

UI Components

User list and creation form components

Polish & Deploy

Styling refinements and Vercel deployment

API surface

GET /api/users

Retrieve all test users

POST /api/users

Create a new test user

GET /api/users/[id]

Retrieve a specific user by ID

DELETE /api/users/[id]

Remove a test user

Data model

User

id: stringname: stringemail: stringcreatedAt: string

Setup

1. Clone the repository 2. Run npm install to install dependencies 3. Run npm run dev to start the development server 4. Open http://localhost:3000 in your browser 5. Deploy to Vercel with vercel --prod or connect your Git repository

Operator notes

• In-memory store will reset on each Vercel deployment or function cold start

• For persistent data, integrate a database in a future iteration

• All API routes return JSON with consistent error shapes

• No rate limiting implemented in alpha

Suggested env vars

NEXT_PUBLIC_APP_URL

Base URL for the application, used for metadata and API calls

FAQ

Where is the data stored?

Data is stored in-memory for this alpha. It resets on each deployment or serverless cold start.

Can I connect a real database?

Yes, the data layer is abstracted and can be swapped for Prisma, Drizzle, or any database client.

Is authentication included?

No, authentication is out of scope for this alpha. Add NextAuth.js or Clerk for production use.