1.0.6 ⢠Published 5 months ago
create-lofi-app v1.0.6
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