startkit-expo

A sane starting point for Expo projects.

Features

• The latest Expo 50 SDK.
• Expo Router
• Tanstack Query with persistent cache
• Toasts!
• Push Notifications
• App settings section
• TailwindCSS for utility-first CSS via Nativewind v4.
• Built-in Dark Mode support
• CSS Variables for themes
• Async preloading with splash screen
• Bun as a package manager
• Typescript for a rock-solid codebase
• Strict, recommended ESLint and Prettier config using the Vercel Style Guide for readable, safe code.
• Extra linting power with Oxlint
• Vitest testing.

Starting a new project with StartKit

1. Clone this repo to your desired path:

   git clone git@github.com:startkit-dev/expo.git my-new-project

2. Rename the project, including ios.bundleIdentifier and android.package in app.json and package.json

3. Update your git remote to point to StartKit as upstream

   git remote rename origin upstream

   In the future, you'll be able to pull in the latest StartKit changes without missing a beat by running:

   git fetch upstream
   git pull upstream/main

Installation

First, run the setup script to install all dependencies and create a local .env.local file:

bun run setup

Running the app

bun run dev

Linting / Checking the codebase

To run a full check of the codebase (type-check, lint, prettier check, test), run:

bun run check

Linting

bun run lint

bun run oxlint

Type Checking

bun run type-check

Formatting with Prettier

bun run format

to check for format errors, run:

bun run format:check

Testing

bun run test

❤️ Open Source

This project is MIT-licensed and is free to use and modify for your own projects.

It was created by Matt Venables.