A collection of markdown spec files that ralph-starter can use as input to generate full projects autonomously.
Note: This repo contains spec files only, not full projects. For built project demos, see ralph-showcase.
Spec files are structured markdown documents that describe a project to build. They include:
- Overview - What the project does
- Features - Key functionality to implement
- Tasks - Step-by-step implementation checklist
- Tech Stack - Technologies to use
- Files to Create - Expected file structure
Ralph reads these specs and builds the entire project autonomously.
| Template | Description | Difficulty |
|---|---|---|
| nextjs-saas | Next.js SaaS with auth, billing, dashboard | Intermediate |
| landing-page | Modern landing page with animations | Beginner |
| express-api | RESTful API with Express.js | Beginner |
| graphql-api | GraphQL API with Apollo Server | Intermediate |
| ecommerce | Full e-commerce platform | Advanced |
| blog-cms | Blog with CMS capabilities | Intermediate |
| Template | Description | Difficulty |
|---|---|---|
| erc20-token | ERC-20 token with tests | Beginner |
| nft-collection | NFT collection with minting | Intermediate |
| defi-staking | DeFi staking platform | Advanced |
| web3-dapp | Web3 dApp with wallet connect | Intermediate |
| Template | Description | Difficulty |
|---|---|---|
| docker-compose | Multi-container Docker setup | Beginner |
| kubernetes | Kubernetes deployment configs | Intermediate |
| github-actions | CI/CD with GitHub Actions | Beginner |
| terraform | Infrastructure as Code | Intermediate |
| Template | Description | Difficulty |
|---|---|---|
| react-native-app | Cross-platform mobile app | Intermediate |
| Template | Description | Difficulty |
|---|---|---|
| aeo-toolkit | Answer Engine Optimization with llms.txt, AI crawlers, citations | Advanced |
| seo-toolkit | Technical SEO with metadata, sitemaps, Core Web Vitals | Intermediate |
| Template | Description | Difficulty |
|---|---|---|
| cli-tool | Node.js CLI application | Beginner |
| chrome-extension | Chrome browser extension | Intermediate |
| vscode-extension | VS Code extension | Intermediate |
# List available specs
ralph-starter template list
# Use a spec to build a project
ralph-starter template use nextjs-saas
# Preview spec content before using
ralph-starter template preview landing-pageEach spec follows a standard markdown structure:
# Project Name
Brief description of what the project does.
## Overview
Detailed explanation of the project purpose and goals.
## Features
- Feature 1
- Feature 2
- Feature 3
## Tasks
### Task 1: Setup
- [ ] Subtask 1
- [ ] Subtask 2
### Task 2: Core Implementation
- [ ] Subtask 1
- [ ] Subtask 2
## Tech Stack
- Technology 1
- Technology 2
## Files to Create
- `src/index.ts`
- `src/components/App.tsx`See CONTRIBUTING.md for guidelines on adding new specs.
MIT