create-eldrin-project

Scaffold new Eldrin applications with a single command.

Usage

npm create eldrin-project@latest -- my-app

Or using npx:

npx create-eldrin-project my-app

Interactive Prompts

The CLI will ask you to choose:

1. Project name - Name of your new project
2. Cloud provider - Cloudflare Workers (more coming soon)
3. Frontend framework - React (more coming soon)
4. Database - SQLite/D1 (more coming soon)
5. Port - Development server port (default: 4001)
6. Developer ID - Your developer identifier (e.g., example.com)
7. Developer name - Your name or organization name

Available Templates

Cloudflare + React + SQLite (Todo App)

A full-featured Todo application with:

• Frontend: React 19, TypeScript, Tailwind CSS
• Backend: Cloudflare Workers
• Database: D1 (SQLite at the edge)
• Features:
  • Create, edit, delete todos
  • Categories for organization
  • Priority levels (low, medium, high)
  • Due dates with overdue indicators
  • Filter by status, priority, category
  • Dark mode support
  • Single-spa integration for Eldrin shell

After Creating a Project

cd my-app
npm install
npm run dev

Open http://localhost:4001 (or your chosen port) in your browser.

Project Structure

my-app/
├── migrations/          # SQL migrations
├── scripts/             # Build scripts
├── src/                 # React frontend
│   ├── components/      # React components
│   ├── main.tsx         # Standalone entry
│   └── eldrin-*.tsx     # Single-spa entry
├── worker/              # Cloudflare Worker API
├── package.json
├── vite.config.ts
└── wrangler.jsonc

Deploying to Cloudflare

1. Create a D1 database:

   wrangler d1 create my-app-db

2. Update wrangler.jsonc with the database ID from the output

3. Deploy:

   npm run deploy

Development

Building the CLI

npm run build

Testing Locally

npm link
create-eldrin-project test-app

Adding New Templates

1. Create a new directory under templates/ (e.g., aws-react-postgresql)
2. Add template files with .template suffix for variable substitution
3. Update src/prompts.ts to enable the new option
4. Build and publish

Template Variables

Templates support these variables:

| Variable | Example | Description | |----------|---------|-------------| | {{appName}} | My Todo App | Original project name | | {{appNameKebab}} | my-todo-app | Kebab-case version | | {{appNamePascal}} | MyTodoApp | PascalCase version | | {{appNameCamel}} | myTodoApp | camelCase version | | {{appNameSnake}} | my_todo_app | snake_case version | | {{port}} | 4001 | Development server port | | {{developerId}} | example.com | Developer identifier | | {{developerName}} | Acme Inc | Developer display name |

License

MIT