@ras-sh/stack

A CLI tool that allows developers to bootstrap TypeScript projects and incrementally add pre-configured modules (like Next.js, Convex, auth providers, etc.) in a composable way.

Features

• 🏗️ Modular Architecture: Add functionality incrementally rather than choosing a monolithic template
• 🔄 Updateable: Pull in updates to modules without losing customizations (coming soon)
• 🎯 Opinionated: Pre-configured with best practices for each technology
• 🚀 Fast: Get started quickly with working configurations

Quick Start

# Create a new project
npx @ras-sh/stack init my-app

# Add modules
cd my-app
npx @ras-sh/stack add nextjs
npx @ras-sh/stack add convex

Available Modules

• nextjs - Next.js 15 with App Router and TypeScript
• convex - Convex backend with real-time sync (requires nextjs)

Module Development

Modules are self-contained and follow this structure:

export const myModule: Module = {
  name: 'my-module',
  description: 'Description of what this module does',
  requires: ['other-module'], // Optional dependencies
  conflicts: ['conflicting-module'], // Optional conflicts

  async canAdd(ctx: Context): Promise<boolean> {
    // Check if module can be added
    return true;
  },

  async add(ctx: Context): Promise<void> {
    // Install dependencies, copy templates, modify files
    await ctx.addDependencies({ 'some-package': '^1.0.0' });
    await ctx.copyTemplates('./templates');
  }
};

License

MIT License - see the LICENSE file for details.