mirror of
https://github.com/MODSetter/SurfSense.git
synced 2025-09-03 19:19:10 +00:00
96 lines
3.1 KiB
Markdown
96 lines
3.1 KiB
Markdown
# Next.js Token Handler Component
|
|
|
|
This project includes a reusable client component for Next.js that handles token storage from URL parameters.
|
|
|
|
## TokenHandler Component
|
|
|
|
The `TokenHandler` component is designed to:
|
|
|
|
1. Extract a token from URL parameters
|
|
2. Store the token in localStorage
|
|
3. Redirect the user to a specified path
|
|
|
|
### Usage
|
|
|
|
```tsx
|
|
import TokenHandler from '@/components/TokenHandler';
|
|
|
|
export default function AuthCallbackPage() {
|
|
return (
|
|
<div>
|
|
<h1>Authentication Callback</h1>
|
|
<TokenHandler
|
|
redirectPath="/dashboard"
|
|
tokenParamName="token"
|
|
storageKey="auth_token"
|
|
/>
|
|
</div>
|
|
);
|
|
}
|
|
```
|
|
|
|
### Props
|
|
|
|
The component accepts the following props:
|
|
|
|
- `redirectPath` (optional): Path to redirect after storing token (default: '/')
|
|
- `tokenParamName` (optional): Name of the URL parameter containing the token (default: 'token')
|
|
- `storageKey` (optional): Key to use when storing in localStorage (default: 'auth_token')
|
|
|
|
### Example URL
|
|
|
|
After authentication, redirect users to:
|
|
```
|
|
https://your-domain.com/auth/callback?token=your-auth-token
|
|
```
|
|
|
|
## Implementation Details
|
|
|
|
- Uses Next.js's `useSearchParams` hook to access URL parameters
|
|
- Uses `useRouter` for client-side navigation after token storage
|
|
- Includes error handling for localStorage operations
|
|
- Displays a loading message while processing
|
|
|
|
## Security Considerations
|
|
|
|
- This implementation assumes the token is passed securely
|
|
- Consider using HTTPS to prevent token interception
|
|
- For enhanced security, consider using HTTP-only cookies instead of localStorage
|
|
- The token in the URL might be visible in browser history and server logs
|
|
|
|
This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
|
|
|
|
## Getting Started
|
|
|
|
First, run the development server:
|
|
|
|
```bash
|
|
npm run dev
|
|
# or
|
|
yarn dev
|
|
# or
|
|
pnpm dev
|
|
# or
|
|
bun dev
|
|
```
|
|
|
|
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
|
|
|
|
You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
|
|
|
|
This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
|
|
|
|
## Learn More
|
|
|
|
To learn more about Next.js, take a look at the following resources:
|
|
|
|
- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
|
|
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
|
|
|
|
You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
|
|
|
|
## Deploy on Vercel
|
|
|
|
The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
|
|
|
|
Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
|