Quick start
Download and run the 4567 macOS app (no installation needed), pick any folder on your computer, and it instantly spins up a clean, mobile-friendly website.
The app continuously watches the folder you selected: subfolders become site pages, and adding an image or text file immediately appears live in your browser. Zero setup (no servers or databases), live preview (instant updates as you add/edit/delete files), and lightning-fast performance.
1. Download & run
Download 4567 for macOS and double-click to run. No installation required.
A new terminal window will open.
2. Choose your website folder
This is the main folder where you'll keep your website content. Use the interactive folder picker to select any folder on your computer:
- Recent Locations: Quick access to your last 5 used folders or
- Select any folder on your computer: Browse for folder... (opens native file picker)
- Current Directory: Use folder where 4567 is currently located
Select option 1. Browse for folder... to choose your website folder.
Let's select a folder from Desktop 📁 start here.
Once you click Choose, 4567 will start using that folder structure as a base for your new website.
3. View Your Website
If you see this message in the Terminal it means your website is running locally:
Open http://localhost:4567 in your browser.
That's it. You're done!
Once you select a folder, 4567 analyzes its contents and creates a simple website based on that folder structure.
Based on the contents of selected folder, 4567 will behave differently:
A. If selected folder is empty
If you point 4567 at an empty folder, you'll see a welcome screen with an Create a Sample Project button.
Click it to automatically generate a sample website.
The folder you selected will be populated with example folders, images, and markdown files to get you started quickly. This gives you a complete working example to understand how 4567 works.
Check the Folders and files generated to explore how it works.
B. If selected folder has existing content
If your folder already has content, 4567 immediately transforms it into a website.
- Subfolders become projects - Each folder is treated as a nav item on homepage, pointing to its own page
- Images are shown instantly when added - Photos in folders automatically show up on the project page
- Add text – To include text or custom content on your pages, simply add a
project.mdorproject.txtfile to any folder. Either file unlocks advanced formatting and customization options for that page. - Instant updates – Changes to files and folders are reflected immediately without needing to restart or refresh the app. Add images, create folders, and edit text – all changes appear in real-time.