create-eng-app

Create englang applications with a single command.

Usage

Interactive (Recommended)

npx create-eng-app@latest my-app
cd my-app
npm run dev

With Template

npx create-eng-app@latest my-app --template react
npx create-eng-app@latest my-server --template express
npx create-eng-app@latest my-project --template basic

Available Templates

basic (default)

A minimal englang project with no framework dependencies. Perfect for learning or building CLI tools.

Features:

• Simple project structure
• TypeScript compilation
• Ready to run with eng run

react

A modern React application powered by englang, Vite, and a glassmorphism dark theme.

Highlights:

• Multi-page router (Home · Examples · About)
• Pure englang components with exports, destructuring, and multi-line JSX returns
• Animated glass UI with pre-styled sections, buttons, and code blocks
• Preconfigured Vite plugin for .eng hot reload
• TypeScript + eslint + npm scripts already wired

express

An Express.js server written in englang.

Features:

• Express web server
• CORS enabled
• JSON body parsing
• TypeScript types included

What You Get

After running create-eng-app, you'll have a project with:

• 📦 Package.json - Pre-configured with all dependencies and scripts
• 🔧 TypeScript Config - Ready for compilation
• 📝 Example Code - Working englang examples that show off the language
• 🎨 UI Styling - Modern glassmorphism theme (React template)
• 🚀 Scripts - dev, build, and preview commands
• 📚 README - Documentation for your new project
• 🙈 .gitignore - Sensible defaults

Development

# Create a new app
npx create-eng-app my-app

# Navigate to your app
cd my-app

# Start development
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

Maintainer Workflow

When updating the React template, run the helper script from the monorepo root:

npm run test-template

This bumps the package version, publishes to npm, regenerates the /tmp/demo-app, and launches Vite so you can verify the changes end-to-end.

Requirements

• Node.js 18.0.0 or higher
• npm or yarn

Learn More

• englang Documentation
• englang Language Guide
• englang Examples
• englang Compiler on npm

License

MIT