⚡ liberia-forge

Scaffold any project in seconds. Describe what you want to build, pick your stack, and Forge sets everything up — dependencies installed, git initialized, editor opened.

Built by Emmanuel Cheeseman from Liberia 🇱🇷

Quick Start

npx liberia-forge

No install required.

Stacks Supported

| Stack | Command Key | |-------|------------| | ⚡ React + Vite | react-vite | | ▲ Next.js 14 | nextjs | | 💚 Vue 3 + Vite | vue-vite | | 🟢 Nuxt 3 | nuxt | | 📱 React Native + Expo | react-native-expo | | 🚀 Node.js + Express API | node-express | | 🔴 Laravel | laravel | | 🔥 SvelteKit | sveltekit | | 🔺 T3 Stack | t3 | | 🚀 Astro | astro | | 🐍 Django | django | | 🐍 Python + FastAPI | python-fastapi |

Features

• Plain English input — describe your project, Forge recommends the right stack
• 12 production stacks — JS, TS, PHP, Python all covered
• Addon picker — Tailwind, Prisma, Chakra UI, Mongoose and more
• Git init — initial commit included automatically
• Editor launch — opens VS Code, Cursor, or Zed when done
• Headless/CI mode — fully scriptable, no prompts needed
• Team config — liberia.config.json sets your defaults once
• 26 passing tests — built to be trusted

Headless Mode (CI / Scripts)

npx liberia-forge --name my-app --stack nextjs --yes

All flags

| Flag | Description | |------|-------------| | --name | Project name | | --stack | Stack key (see table above) | | --addons | Comma-separated addon keys | | --dir | Output directory | | --yes | Skip all prompts | | --dry-run | Preview without creating files | | --no-git | Skip git initialization |

Examples

# Dry run to preview
npx liberia-forge --name my-app --stack react-vite --yes --dry-run

# Laravel project, no git
npx liberia-forge --name api --stack laravel --yes --no-git

# FastAPI with SQLAlchemy
npx liberia-forge --name backend --stack python-fastapi --addons sqlalchemy --yes

Team Config

Create a liberia.config.json in your project root or home folder:

{
  "defaultStack": "nextjs",
  "defaultDir": "~/Projects",
  "defaultEditor": "code",
  "defaultAddons": ["tailwind"],
  "git": true
}

Forge reads it on startup and skips those questions automatically. Flags always override config.

Requirements

• Node.js 18+
• For Laravel: PHP 8.2+ and Composer
• For Django / FastAPI: Python 3.8+

License

MIT © Emmanuel Cheeseman