KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #ai-agent #developer-tools #claude-code #codex #deepseek-harness #ai-agents #react #mcp #rust

fast_login_db

★ 229 Open GitHub ↗

Fast Register and Login

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# fast_login_db

## Architecture

- Nuxt is the only browser-facing service and proxies same-origin `/api/**` requests.
- FastAPI owns validation, password hashing, users, and server-side sessions.
- PostgreSQL stores users and hashed session tokens.
- Authentication uses an HttpOnly, SameSite cookie. Tokens are never exposed to frontend code.

## Start with Docker

```sh
docker compose up -d --build
```

Open:

- App: http://127.0.0.1:3000
- OpenAPI: http://127.0.0.1:8000/docs

The `migrate` service applies Alembic migrations before the backend starts. Existing databases
created by the previous version are detected by the baseline migration and upgraded without
dropping users.

## Local development

Requires Python 3.10+, uv, and Node 24. The frontend includes an `.nvmrc`.

```sh
make setup
make migrate
```

Run the services in separate terminals:

```sh
cd backend && uv run uvicorn app.main:app --reload
cd frontend && npm run dev
```

Set `NUXT_API_BASE_URL=http://127.0.0.1:8000` when the frontend cannot use the default.

## Quality checks

```sh
make check
```

This runs backend lint and API tests plus frontend lint, type checking, unit tests, and a
production build.

Copy `.env.example` to `.env` only when you need to override defaults. In HTTPS production,
set `SESSION_COOKIE_SECURE=true`.

fast_login_db

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README