Quick Start Guide
Get Simple Manager up and running on your device in under 5 minutes. This guide will walk you through starting the development server, running the app, and creating your first record.Make sure you’ve completed the Installation steps before proceeding.
Start the Development Server
Start Expo Development Server
Start the Expo development server:Or use the Expo CLI directly:This will start Metro bundler and display a QR code in your terminal.
Run on Different Platforms
iOS (macOS only)
- Start the Metro bundler
- Open iOS Simulator
- Build and install the app
- Launch Simple Manager
Android
Web
http://localhost:8081.
Physical Device with Expo Go
Install Expo Go
Download Expo Go from:
- App Store (iOS)
- Google Play (Android)
Connect to Same Network
Ensure your development machine and mobile device are on the same Wi-Fi network.
Create Your First Record
Now that the app is running, let’s create your first record!Open the App
You should see the Simple Manager home screen with the title “Simple Manager” and two input fields: Title and Type.
The database is automatically initialized when you first launch the app using expo-sqlite.
Enter Record Details
Fill in the form:
- Title: Enter a name for your record (e.g., “John Doe”, “Morning Meeting”)
- Type: Enter a category (e.g., “client”, “task”, “appointment”)
Save the Record
Tap the “Guardar” (Save) button. You’ll see:
- A success toast notification
- Your new record appears in the list below
- The form clears automatically
Understanding the Code
Here’s what happens when you create a record:Using the useRecords Hook
Component Usage
Record Creation Flow
The data flows through the clean architecture layers:RecordService.create()
Records are stored in a local SQLite database using expo-sqlite. All operations are offline-first - no internet connection required!
Record Interface
Every record follows this TypeScript interface:Record Entity
Common Development Commands
Here are some useful commands for development:Clear Cache and Restart
Run Linter
Reset Project
Next Steps
Architecture
Learn about the Clean Architecture structure and how the layers interact
Data Model
Explore the Record entity, database schema, and validation rules
Customization
Customize the UI, add new record types, and extend functionality
API Integration
Learn how to migrate from SQLite to a backend API
Troubleshooting
App Won’t Start
Database Issues
If you’re having database-related issues:- The database is automatically created on first launch
- Database file location: Device’s local storage (managed by expo-sqlite)
- To reset: Uninstall the app and reinstall
Validation Errors
Need Help?
If you encounter issues not covered here, check the project’s GitHub issues or create a new one with details about your problem.