https://github.com/jonluca/ca-dmv-plate-finder
https://github.com/jonluca/ca-dmv-plate-finder
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/jonluca/ca-dmv-plate-finder
- Owner: jonluca
- Created: 2025-08-28T19:52:33.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-28T22:13:45.000Z (10 months ago)
- Last Synced: 2025-08-29T02:54:40.859Z (10 months ago)
- Language: TypeScript
- Size: 27.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CA DMV Plate Finder
A script that finds available custom license plates through the California DMV's online system. This is the codebase corrsponding to this blog post on [finding available California license plates](https://blog.jonlu.ca/posts/ca-plate-checker).
## Prerequisites
- [Bun](https://bun.sh/)
## Installation
1. Clone the repository:
```bash
git clone https://github.com/yourusername/CA-DMV-Plate-Finder.git
cd CA-DMV-Plate-Finder
```
2. Install dependencies:
```bash
bun install
```
## Usage
### Running the Application
```bash
bun run find-plates
```
Or directly:
```bash
bun src/index.ts
```
### Customizing Plate Input
The application supports two methods for providing plates to check:
#### Method 1: Using a plates.txt File (Recommended)
Create a `plates.txt` file in the project root with one plate per line:
```
ABC123
TESLA1
GITHUB
CODING
```
The application will automatically detect and stream plates from this file.
#### Method 2: Generating Combinations
If no `plates.txt` file exists, the application will generate 3-character combinations. You can modify the `getNextPlate()` generator in `src/index.ts` to customize the generation pattern:
```typescript
import { combinationsWithReplacement } from "combinatorial-generators";
async function* getNextPlate(): AsyncGenerator {
const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
for (const combo of combinationsWithReplacement(chars, 3)) {
yield combo.join("");
}
}
```