create-lofi-app

A starter kit for building local-first apps

About

⚠️ still in beta, so expect some rough edges. open to feedback and contributions!

create-lofi-app is an opinionated starter kit for building local-first apps. It's designed to be an easy starting point for learning about local-first development.

Out of the box, the default template comes with React, Vite, Tailwind, and React Router.

It also includes BasicDB, a database and sync layer for user-owened data.

Features

• 🚀 Vite for lightning-fast development
• ⚛️ React 19 with TypeScript
• 🛣️ React Router for client-side routing
• 💅 Tailwind CSS for easy styling
• 📱 Vite-PWA - offline ready
• 💾 Basic for local-first db & sync

Installation

npx create-lofi-app my-app
cd my-app

Development

# Install dependencies
npm install

# Start development server
npm run dev

Your app will be available at http://localhost:5173

Building for Production

# Create production build
npm run build

# Preview production build
npm run preview

Project Structure

my-app/
├── src/
│   ├── assets/       # Images, fonts, and other static files
│   ├── App.tsx       # Main application component
│   └── main.tsx      # Application entry point
├── public/           # Static assets
├── index.html        # HTML template
└── basic.config.ts   # Basic database schema configuration

Why Local-First?

Local-first applications prioritize storing data on the user's device while optionally syncing with the cloud. This approach offers several benefits:

• 🔒 Better privacy and data ownership
• ⚡ Faster performance
• 📴 Offline functionality

License

MIT