Install Makeshaper Now
Open your terminal SLOT. Run this command: npm install -g makeshaper. Wait for the installation to complete. Verify it worked by typing: makeshaper –version. You should see a version number. This takes two minutes.
Create Your First Project
Navigate to your projects directory. Use the command: makeshaper init my-app. Replace ‘my-app’ with your project name. The tool scaffolds a complete structure. It creates config files, source folders, and a basic build pipeline. Do not edit anything yet. Just observe the generated layout.
Understand The Core Commands
You only need three commands to start. First, makeshaper build. This compiles your project for production. Second, makeshaper dev. This starts a live development server with hot reload. Third, makeshaper deploy. This packages and pushes your project to a configured host. Run makeshaper dev now.
Configure Your Project
Open the makeshaper.config.js file in your project root. This is your control panel. Locate the ‘entry’ field. This defines your main application file. Locate the ‘output’ field. This sets your build directory. Change the output path to ‘./dist’. Save the file. Your builds now go to the ‘dist’ folder.
Add Your First Plugin
Makeshaper uses plugins for functionality. Go back to makeshaper.config.js. Find the plugins array. Add a new line: new MakeshaperImagePlugin(). You must import it first. Add this at the top of the config file: const { MakeshaperImagePlugin } = require(‘makeshaper’);. This plugin optimizes images automatically.
Write And Preview Code
Open the ‘src’ directory. Edit the main.js file. Write a simple console.log(‘Hello Makeshaper’);. Save the file. Your terminal running makeshaper dev will show a log. The browser will refresh automatically. See the change instantly. This is your development loop. Code, save, observe.
Run A Production Build
Stop the dev server with Ctrl+C. Run the build command: makeshaper build. Watch the terminal. The tool minifies code, optimizes assets, and tree-shakes dependencies. Check the ‘./dist’ folder. You will find compressed, production-ready files. The entire process is automatic.
Set Up A Deployment
Connect your project to a Git repository. Initialize git with: git init. Commit your code. Then, run makeshaper deploy –setup. Follow the prompts to link your hosting service (like Vercel or Netlify). The tool guides you through authentication. After setup, run makeshaper deploy alone to push updates.
Enable Advanced Optimizations
Reopen makeshaper.config.js. Find the optimization section. Set ‘minify’ to true. Set ‘bundleAnalyze’ to false for now. Enable code splitting by adding: splitChunks: { chunks: ‘all’ }. This improves load times. Save the config. Run makeshaper build again to apply these optimizations.
Next Steps: Explore Plugins
Your base workflow is ready. Visit the official Makeshaper plugin directory. Add the TypeScript plugin for static typing. Add the SCSS plugin for advanced styling. Install plugins via npm. Add them to your config file. Each plugin expands capability without complex setup. Start building your real project now.
