{"id":28902446,"url":"https://github.com/pxycknomdictator/excli-express","last_synced_at":"2026-01-20T17:30:51.107Z","repository":{"id":298879132,"uuid":"1000477019","full_name":"pxycknomdictator/excli-express","owner":"pxycknomdictator","description":"A cli tool for creating Express.js applications, supporting both JavaScript and TypeScript.","archived":false,"fork":false,"pushed_at":"2025-06-20T18:58:18.000Z","size":94,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-20T19:14:23.481Z","etag":null,"topics":["database","docker","express-cli","javascript","npm","typescript"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@excli/express","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pxycknomdictator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-11T21:06:27.000Z","updated_at":"2025-06-20T18:58:21.000Z","dependencies_parsed_at":"2025-06-13T18:40:43.390Z","dependency_job_id":null,"html_url":"https://github.com/pxycknomdictator/excli-express","commit_stats":null,"previous_names":["pxycknomdictator/express-cli-wizard","pxycknomdictator/excli-express"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pxycknomdictator/excli-express","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pxycknomdictator%2Fexcli-express","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pxycknomdictator%2Fexcli-express/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pxycknomdictator%2Fexcli-express/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pxycknomdictator%2Fexcli-express/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pxycknomdictator","download_url":"https://codeload.github.com/pxycknomdictator/excli-express/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pxycknomdictator%2Fexcli-express/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261110622,"owners_count":23111066,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","docker","express-cli","javascript","npm","typescript"],"created_at":"2025-06-21T11:08:57.996Z","updated_at":"2026-01-20T17:30:51.074Z","avatar_url":"https://github.com/pxycknomdictator.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"### Express.js CLI Tool\n\nA powerful express generator tool for creating production-ready Express.js applications with TypeScript/JavaScript support, complete with Docker containerization and database management.\n\n[![npm version](https://badge.fury.io/js/%40excli%2Fexpress.svg)](https://badge.fury.io/js/%40excli%2Fexpress)\n[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)\n[![Node.js](https://img.shields.io/badge/Node.js-20+-green.svg)](https://nodejs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)\n\n---\n\n### Why Choose This Generator?\n\nStart building features immediately with a complete, production-ready Express.js project using industry best practices.\n\n**Built for modern development:**\n\n- 🚀 TypeScript or JavaScript support\n- 🐳 Docker-ready with one command\n- 🗄️ Pre-configured databases (MySQL, MariaDB, PostgreSQL, MongoDB)\n- 🔥 Hot reload for rapid development\n- 📦 Clean, scalable architecture\n- 🛠️ Admin panels included for database management\n- 🐶 Husky integration for Git hooks\n- ⚡ Modern Node.js APIs (no deprecated methods)\n\n---\n\n### Getting Started\n\nNo installation needed! Just run:\n\n```bash\nnpx @excli/express\n```\n\n**Or install globally:**\n\n```bash\nnpm install -g @excli/express\nexcli\n```\n\n#### Requirements\n\n- Node.js 20 or higher\n- npm, yarn, pnpm or bun\n- Docker (optional - only needed for database features)\n\n---\n\n### Usage\n\n#### Creating Your Project\n\nRun the CLI and answer a few simple questions:\n\n```bash\nnpx @excli/express\n```\n\n**You'll be asked about:**\n\n1. **Project Name** - What to call your new application\n2. **Language** - TypeScript or JavaScript\n3. **Project Mode** - Normal (basic setup) or Production (includes Docker \u0026 databases)\n4. **Development Tools** - Git, Prettier, Docker, Husky\n5. **Database** - Choose MySQL, MariaDB, PostgreSQL, or MongoDB (production mode only)\n\n### Starting Your Application\n\nAfter project creation:\n\n```bash\n# Navigate to your project\ncd my-project\n\n# Start the development server\nnpm run dev\n\n# Open your browser at http://localhost:3000\n```\n\nThat's it! Your Express server is running with hot reload enabled.\n\n---\n\n### What's Included\n\n#### Husky Integration\n\nWhen enabled, Husky automatically sets up Git hooks to maintain code quality:\n\n- **Pre-commit hook** - Runs linting and formatting checks before commits\n- **Pre-push hook** - Ensures tests pass before pushing to remote\n- **Commit message validation** - Enforces conventional commit standards\n\n#### Database Options\n\nChoose the database that fits your needs:\n\n| Database       | Admin Panel   | Admin Panel Port |\n| -------------- | ------------- | ---------------- |\n| **MySQL**      | phpMyAdmin    | 6969             |\n| **MariaDB**    | phpMyAdmin    | 6969             |\n| **PostgreSQL** | pgAdmin       | 6969             |\n| **MongoDB**    | Mongo Express | 6969             |\n\nAll admin panels are accessible at `http://localhost:6969` after running `npm run docker:up`.\n\n\u003e **Note:** Some admin panels might take a minute to initialize. Why? Great question! I wish I knew. Please be patient during first startup while they contemplate the meaning of life.\n\n### Docker \u0026 Environment Files\n\nYour project includes pre-configured Docker setup:\n\n- **Dockerfile** - Production-ready container configuration\n- **.env files** - Environment variables for different environments\n- **docker-compose.yml** - Multi-service orchestration with proper volume paths\n\n\u003e **Important:** PostgreSQL volume path has been fixed in the latest version to ensure proper data persistence across container restarts.\n\n---\n\n### Common Commands\n\n#### Development\n\n```bash\nnpm run dev          # Start development server with hot reload\nnpm run start        # Start production server\nnpm run format       # Format code with Prettier\n```\n\n#### TypeScript Projects\n\n```bash\nnpm run build        # Compile TypeScript to JavaScript\n```\n\n#### Docker \u0026 Databases\n\n```bash\nnpm run docker:up    # Start database and admin panel\nnpm run docker:down  # Stop all Docker services\n```\n\n---\n\n### Managing Your Database\n\nAfter running `npm run docker:up`, access your database admin panel at **http://localhost:6969**\n\n- **pgAdmin** - Full-featured PostgreSQL management\n- **phpMyAdmin** - Intuitive MySQL \u0026 MariaDB interface\n- **Mongo Express** - Simple MongoDB administration\n\n---\n\n### Recent Updates\n\n#### Version Improvements\n\n- ✅ Fixed PostgreSQL volume path in Docker configuration for proper data persistence\n- ✅ Added production-ready Dockerfile\n- ✅ Improved environment variable management\n- ✅ Modern Node.js APIs (no deprecated methods)\n- ✅ Cross-platform compatibility improvements\n\n---\n\n### Troubleshooting\n\n**Port already in use?**\nCheck if another service is running on port 3000 or 6969, or modify the ports in your `.env` file.\n\n**Docker issues?**\nMake sure Docker Desktop is running before executing `npm run docker:up`.\n\n**Husky hooks not running?**\nEnsure Git is initialized and add a valid script in `.husky/pre-commit` file, then run `npm run prepare` to set up hooks.\n\n**Need help?**\nOpen an issue on GitHub with details about your problem.\n\n---\n\n### Contributing\n\nContributions are welcome! Feel free to:\n\n- Report bugs\n- Suggest new features\n- Submit pull requests\n- Improve documentation\n\n---\n\n### License\n\nISC License - see LICENSE file for details.\n\n### Author\n\n**Noman**  \n📧 [pxycknomdictator@gmail.com](mailto:pxycknomdictator@gmail.com)  \n🐙 [@pxycknomdictator](https://github.com/pxycknomdictator)\n\n---\n\n**Happy coding! Built with ❤️ for developers who value productivity.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpxycknomdictator%2Fexcli-express","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpxycknomdictator%2Fexcli-express","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpxycknomdictator%2Fexcli-express/lists"}