SpeedLoaf

⚡️ Ultra-fast, modern full-stack TS starter for Bun.sh based apps using familiar JSX templating ⚡️
JSX is used as a templating language for familiarity, but this is not a React framework.
Focusing on web standards, separation of concerns, and leveraging modern tooling to get shit built fast.
Supports web components and lets you opt-in to React for specific pages if needed.

---

🚀 Features

• Bun-powered: Lightning-fast dev/build with Bun
• Familiar JSX/TSX templating: Use the syntax you know, but not tied to any framework
• Web standards first: Embraces native HTML, CSS, and JavaScript
• Separation of concerns: Encourages clean, maintainable code structure
• Modern frontend tooling: Integrates with your favorite tools and workflows
• Web components support: Use or author custom elements natively
• Opt-in React: Use React only where you need it—per page
• Server-side rendering: TSX-based static/server components
• HTML streaming: Powered by react-dom/server in Bun
• TypeScript-first: Everything is writte in TS and wired up by Bun
• Easy deploy: Instantly deployable to Railway

---

🏁 Quick Start

bun install
bun run dev

Then visit http://localhost:3000

---

📁 Folder Structure

SpeedLoaf just wants you to seperate your backend logic and view creation (HTML) from your frontend code (style and interactivity). You can do what you like in terms of dir structure but here is the high level:

├── public/           # Static assets (logo, etc)
├── src/
│   ├── client/       # Frontend (component and page CSS + JS)
│   ├── server/       # Server routes, SSR templates using JSX (views)
│   └── types/        # Shared TypeScript types
├── dist/             # Build output
├── package.json      # Project metadata & scripts
└── README.md         # This file

---

🤝 Contributing

Contributions are welcome! Please open issues or PRs. Use bun commit to trigger the gitmoji commit message builder.

---

☁️ Deploy

Deploy instantly on Railway:

1. Push to GitHub
2. Create a new Railway project
3. Select your repo
4. Watch it fly!

---

📄 License

MIT — free for personal and commercial use.

---

Made with ❤️ in Sheffield, UK