I actually built 3 projects using SuperClaude. I confirmed once again that learning by doing is faster than just reading documentation. Hands-on learning is the quickest way.
Today, we'll build 3 projects with SuperClaude: a bookmark app, a recipe API, and a collaborative whiteboard.
Preparation
You need to have SuperClaude installed:
python3 -m SuperClaude --version
If you see the version, you're good. If not, install it first.
Project 1: Bookmark Manager App
We'll create a web app to manage browser bookmarks. It categorizes by tags, enables searching, and shows previews.
Step 1: Setting Up the Structure
Create and enter the folder:
mkdir bookmark-manager
cd bookmark-manager
Start with the design:
/sc:design --webapp --crud "bookmark manager with tags and preview"
The component structure is generated. It tells you that you need a bookmark list, search bar, tag filter, and add form.
It also suggests a data model. It includes URL, title, description, tag array, and creation date.
Step 2: Creating the React App
Initialize the project:
/sc:implement --react --vite "bookmark manager"
A React project is created with Vite. TypeScript configuration is included.
Create the main component:
/sc:implement --component "BookmarkCard with preview thumbnail"
A card-style UI is generated. It displays the site favicon, title, URL, and tags.
Add the search feature:
/sc:implement --feature "search bar with tag filtering"
Search by title and filter by clicking tags. Debouncing is also applied.
Step 3: Local Storage Integration
Save the data:
/sc:implement --storage "localStorage with JSON persistence"
Add, edit, and delete operations are all reflected in local storage.
Step 4: Refining Styles
Make it look good:
/sc:improve --styling "modern card layout with hover effects"
A grid layout is applied. Shadows appear on hover. Dark mode is also supported.
Make it responsive:
/sc:implement --responsive "mobile and tablet layouts"
One card per row on mobile, two per row on tablet.
Step 5: Writing Tests
Test the components:
/sc:test --component "BookmarkCard render and interactions"
Test bookmark adding, deleting, and tag filtering. Uses Jest and React Testing Library.
Done!
The bookmark app was created in 20 minutes. You can use it locally right away.
Project 2: Recipe Sharing API
Let's build a backend. An API to register recipes, search by ingredients, and give ratings.
Step 1: API Design
Define the endpoints:
/sc:design --api --rest "recipe sharing with ingredients and ratings"
You'll get this structure suggestion:
GET /api/recipes # Recipe list
GET /api/recipes/:id # Recipe details
POST /api/recipes # Register recipe
PUT /api/recipes/:id # Update recipe
DELETE /api/recipes/:id # Delete recipe
GET /api/recipes/search # Search by ingredients
POST /api/recipes/:id/rating # Submit rating
Step 2: Building the Express Server
Create the server:
/sc:implement --express --typescript "recipe API server"
Express boilerplate is generated. Middleware, error handler, and logger are configured.
Define the database schema:
/sc:implement --prisma --schema "Recipe, Ingredient, Rating"
A Prisma schema is created. Recipes and ingredients have a many-to-many relationship. Ratings belong to recipes.
Step 3: Implementing CRUD
Create recipe endpoints:
/sc:implement --crud "recipe with image upload and pagination"
List queries are paginated. Images are uploaded with Multer. Thumbnails are auto-generated.
Add search functionality:
/sc:implement --search "by ingredients with AND/OR logic"
You can find "recipes with tomato and basil." "Pasta or risotto" can also be searched.
Step 4: Authentication System
Add login functionality:
/sc:implement --auth --passport "local strategy with sessions"
Authenticate with Passport.js. Sessions are stored in Redis.
Registration endpoint:
/sc:implement --endpoint "user registration with validation"
Validates email format and password strength. Hashes with bcrypt.
Step 5: Documentation
Create API documentation:
/sc:document --openapi "recipe API specification"
Create the Socket.io server:
/sc:implement --websocket "whiteboard server with room management"
Create and join rooms. Broadcast drawing events. Clean up when connections are lost.
Share cursor positions:
/sc:implement --feature "real-time cursor tracking"
Other people's cursors are visible. Distinguished by color. Names are also displayed.
Step 3: Canvas Editor
Create the drawing board:
/sc:implement --canvas "drawing tools with pen, eraser, shapes"
Pen tool, eraser, and shape drawing work. You can adjust color and thickness.
Add a layer system:
/sc:implement --feature "layer management with z-index"
Draw on multiple layers. Reorder and show/hide them.
Step 4: Real-time Synchronization
Connect the Socket.io client:
/sc:implement --client "socket.io client with event handlers"
Send drawing events to the server. Receive and render other people's drawings.
Handle conflicts:
/sc:implement --sync "operational transformation for drawing"
Even when drawing in the same place simultaneously, nothing breaks. Handled with OT algorithm.
Step 5: Additional Features
Upload images:
/sc:implement --upload "drag and drop image to canvas"
Drag and drop to upload images. Resize and move them.
Add text:
/sc:implement --text "text tool with fonts and colors"
Write text on the whiteboard. Change font, size, and color.
Undo/Redo:
/sc:implement --history "undo/redo with command pattern"
Ctrl+Z to undo. Ctrl+Shift+Z to redo.
Step 6: Production Ready
Optimize performance:
