Skip to content

Releases: icancodefyi/basecompose

v0.1.0

17 Jan 16:49
@icancodefyi icancodefyi
v0.1.0
069cc67

Choose a tag to compare

View all tags
v0.1.0 Latest
Latest

BaseCompose v0.1.0 - First Release

The initial release of BaseCompose, an early-stage tool for generating production-ready project foundations using a chat-based workflow.

What is BaseCompose?

BaseCompose is a tool for generating production-ready project foundations using a chat-based workflow. This release focuses on the core project generation flow. Chat with an AI to specify your desired stack (frontend, backend, database, auth), and with one command get a runnable .tar.gz file to setup, or push it directly to a new GitHub repository.

Key Features

Chat-Based Project Creation

  • Natural Language Interface: Describe your ideal stack in plain language
  • Intelligent Setup: Automatically configures authentication, databases, and environment variables
  • One-Command Generation: Get a complete, runnable project instantly

Instant Downloads

  • ZIP Export: Download your generated project as a ready-to-use archive
  • GitHub Export: Push your project directly to a new GitHub repository
  • Pre-Configured: Includes Docker setup, environment templates, and all dependencies
  • Deploy Anywhere: Run locally or push to production immediately

Built-in Authentication

  • Google OAuth: Seamless authentication with Google using NextAuth
  • Production Ready: Secure by default with best practices included
  • User Management: Project access control and team collaboration ready

Docker Ready

  • docker-compose.yml: Auto-generated for your entire stack
  • One Command Deploy: docker-compose up to start everything
  • Service Isolation: Database, backend, frontend all containerized

Project Management

  • Save & Reuse: Store multiple project configurations
  • Chat History: Review how you built each project
  • Iteration: Modify and regenerate anytime

What You Get

  • Full-stack generation (frontend, backend, database, auth)
  • Docker Compose files ready to use
  • Smart dependency handling
  • Multiple project storage
  • Chat history
  • GitHub integration
  • Browser-based workflow

Supported Technologies

  • Frontend: Next.js
  • Backend: Node.js + Express, FastAPI
  • Database: MongoDB, PostgreSQL, Redis
  • Authentication: Auth.js

Getting Started

Online Version

Visit basecompose, chat with the AI, download your stack, and run docker-compose up.

Run Locally

git clone https://github.com/icancodefyi/basecompose
cd basecompose
pnpm install

# Set up your API key (get it from Groq)
echo "GROQ_API_KEY=your_key_here" > .env.local

pnpm dev

Then navigate to http://localhost:3000.

Documentation

Architecture

BaseCompose is built as a pnpm monorepo with the following structure:

├── app/                    # Next.js web application
│   ├── api/               # API routes
│   │   ├── chat/          # AI chat endpoint
│   │   ├── generate/      # Stack generation
│   │   └── projects/      # Project management
│   └── components/        # UI components
└── packages/
    ├── engine/            # Stack generation logic
    │   ├── resolve.ts     # Dependency resolution
    │   ├── generate.ts    # Generation orchestration
    │   └── emit/          # File generation
    └── types/             # Shared type definitions
        ├── blueprint.ts   # Stack definition schema
        └── stack-config.ts # Supported technologies

Technology Stack

  • Next.js 16 for the web application
  • TypeScript for type safety
  • shadcn/ui and Tailwind CSS for UI
  • Groq API with Kimi model for AI capabilities
  • MongoDB for project storage
  • Auth.js for authentication
  • Docker and Docker Compose for containerization
  • pnpm for monorepo management

Contributing

BaseCompose is open source. You can contribute by:

  • Reporting bugs or unexpected behavior
  • Suggesting new technologies to support
  • Improving documentation
  • Addressing UI/design issues
  • Adding new features

Links

License

MIT - see LICENSE

This is the first release. More features are planned. For questions, open an issue or start a discussion on GitHub.

Assets 2
Loading