Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 39 additions & 0 deletions FAQ.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
## ❓ Frequently Asked Questions (FAQ)

**Q1: What makes Celtrix stand out from other project scaffolding tools?**
A1: Celtrix provides ready-to-use templates, supports multiple popular stacks, and follows modern best practices, allowing you to start projects quickly without setting up everything manually.

**Q2: How do I add a new stack or template to Celtrix?**
A2: You can create a new template in the `templates/` folder following the existing folder structure. Test it using the CLI and then submit a Pull Request to contribute.

**Q3: Are projects created with Celtrix ready for production?**
A3: Celtrix projects give you a strong foundation for development. Some adjustments may be needed for production depending on your specific project requirements.

**Q4: Which stacks are currently available in Celtrix?**
A4: Celtrix currently supports MERN, MEAN, T3, Angular+Tailwind, and several other popular stacks. Contributors can add more stacks.

**Q5: Do I need to install anything globally to use Celtrix?**
A5: No, you don’t need global installations. Simply run `npx celtrix my-awesome-app` and follow the interactive prompts to start a project.

**Q6: Can I customize the generated templates?**
A6: Absolutely! You can modify components, styles, API setups, and configurations to match your project’s requirements.

**Q7: How can I report bugs or request new features?**
A7: Open a GitHub Issue in the Celtrix repository. Provide clear steps, screenshots, and a description to help maintainers understand and address your request.

**Q8: Does Celtrix support TypeScript projects?**
A8: Yes, most templates offer optional TypeScript support. You can choose TypeScript when setting up a new project.

**Q9: Can I use Celtrix for commercial projects?**
A9: Yes! Celtrix is open-source under the ISC license, so you can use it for personal or commercial projects following the license terms.

**Q10: How can I improve or update existing templates?**
A10: Fork the repository, make your changes in a separate branch, test them, and submit a Pull Request. Ensure your updates follow the coding guidelines.

**Q11: What prerequisites do I need to use Celtrix?**
A11: You only need Node.js and npm installed. Celtrix will handle other dependencies automatically during project setup.

**Q12: Where can I get support or join the Celtrix community?**
A12: You can ask questions via GitHub Discussions or join the community chat if available. Always stay respectful and constructive while engaging.

---
62 changes: 15 additions & 47 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,34 +7,37 @@
</div>
<div align="center">

[![npm version](https://img.shields.io/npm/v/celtrix.svg)](https://www.npmjs.com/package/celtrix)
[![Downloads](https://img.shields.io/npm/dm/celtrix.svg)](https://www.npmjs.com/package/celtrix)
[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
[![npm version](https://img.shields.io/npm/v/celtrix.svg)](https://www.npmjs.com/package/celtrix)
[![Downloads](https://img.shields.io/npm/dm/celtrix.svg)](https://www.npmjs.com/package/celtrix)
[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)

</div>

# ✨ Features

### 🎯 **Multiple Stack Options**
Choose from **7+ popular stacks** including MERN, MEAN, T3, Angular+Tailwind, and more!

Choose from **8+ popular stacks** including MERN, MEAN, Next.js+Express+MongoDB, T3, and more!

<div align="center">
<img width="250" height="250" alt="Celtrix Stack Selection Demo" src="https://github.com/user-attachments/assets/7b6a30be-1e34-443e-a906-8c167230c238" />
</div>

### 🌐 **Language Flexibility**

Pick your preferred programming languages and frameworks to match your workflow.

<div align="center">
<img width="250" height="250" alt="Celtrix Language Selection" src="https://github.com/user-attachments/assets/3f8c775a-b747-4eb1-a22d-c1f236276934" />
</div>

### 🛠️ **Ready-to-Go Setup**
- **ESLint** configuration included
- **Sample components** and boilerplate code
- **API setup** with best practices
- **Automatic dependency installation**
- **Modern development tools** pre-configured

- **ESLint** configuration included
- **Sample components** and boilerplate code
- **API setup** with best practices
- **Automatic dependency installation**
- **Modern development tools** pre-configured

---

Expand All @@ -50,44 +53,9 @@ That's it! Follow the interactive prompts to customize your project.

---

## ❓ Frequently Asked Questions (FAQ)

**Q1: What makes Celtrix stand out from other project scaffolding tools?**
A1: Celtrix provides ready-to-use templates, supports multiple popular stacks, and follows modern best practices, allowing you to start projects quickly without setting up everything manually.

**Q2: How do I add a new stack or template to Celtrix?**
A2: You can create a new template in the `templates/` folder following the existing folder structure. Test it using the CLI and then submit a Pull Request to contribute.

**Q3: Are projects created with Celtrix ready for production?**
A3: Celtrix projects give you a strong foundation for development. Some adjustments may be needed for production depending on your specific project requirements.

**Q4: Which stacks are currently available in Celtrix?**
A4: Celtrix currently supports MERN, MEAN, T3, Angular+Tailwind, and several other popular stacks. Contributors can add more stacks.

**Q5: Do I need to install anything globally to use Celtrix?**
A5: No, you don’t need global installations. Simply run `npx celtrix my-awesome-app` and follow the interactive prompts to start a project.

**Q6: Can I customize the generated templates?**
A6: Absolutely! You can modify components, styles, API setups, and configurations to match your project’s requirements.

**Q7: How can I report bugs or request new features?**
A7: Open a GitHub Issue in the Celtrix repository. Provide clear steps, screenshots, and a description to help maintainers understand and address your request.

**Q8: Does Celtrix support TypeScript projects?**
A8: Yes, most templates offer optional TypeScript support. You can choose TypeScript when setting up a new project.

**Q9: Can I use Celtrix for commercial projects?**
A9: Yes! Celtrix is open-source under the ISC license, so you can use it for personal or commercial projects following the license terms.

**Q10: How can I improve or update existing templates?**
A10: Fork the repository, make your changes in a separate branch, test them, and submit a Pull Request. Ensure your updates follow the coding guidelines.

**Q11: What prerequisites do I need to use Celtrix?**
A11: You only need Node.js and npm installed. Celtrix will handle other dependencies automatically during project setup.

**Q12: Where can I get support or join the Celtrix community?**
A12: You can ask questions via GitHub Discussions or join the community chat if available. Always stay respectful and constructive while engaging.
## FAQ

You can now find the full list of FAQs here: [FAQ.md](./FAQ.md)

---

Expand Down
3 changes: 2 additions & 1 deletion index.js
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ async function askStackQuestions() {
{ name: chalk.bold.magenta("MEAN") + " + Tailwind + Auth", value: "mean+tailwind+auth" },
{ name: chalk.bold.cyan("MEVN") + " → MongoDB + Express + Vue.js + Node.js", value: "mevn" },
{ name: chalk.bold.yellow("MEVN") + " + Tailwind + Auth", value: "mevn+tailwind+auth" },
{ name: chalk.bold.blue("Next.js + Express + MongoDB") + " → TypeScript-first full-stack", value: "next+express+mongodb" },
{ name: chalk.bold.yellow("Next.js") + " + tRPC + Prisma + Tailwind + Auth", value: "t3-stack" },
{ name: chalk.bold.red("Hono") + " → Hono + Prisma + React", value: "hono" }

Expand Down Expand Up @@ -85,7 +86,7 @@ async function main() {
}
const stackAnswers = await askStackQuestions();
config = { ...stackAnswers, projectName };


console.log(chalk.yellow("\n🚀 Creating your project...\n"));
await createProject(projectName, config);
Expand Down
Loading